From 760c4888d30f532df8abc725849190487c056d22 Mon Sep 17 00:00:00 2001 From: Praful Makani Date: Thu, 8 Oct 2020 21:35:04 +0530 Subject: [PATCH] docs(samples): add share connection (#161) * docs(samples): add share connection * docs(samples): update member --- .../bigqueryconnection/ShareConnection.java | 59 ++++++++++ .../bigqueryconnection/ShareConnectionIT.java | 106 ++++++++++++++++++ 2 files changed, 165 insertions(+) create mode 100644 samples/snippets/src/main/java/com/example/bigqueryconnection/ShareConnection.java create mode 100644 samples/snippets/src/test/java/com/example/bigqueryconnection/ShareConnectionIT.java diff --git a/samples/snippets/src/main/java/com/example/bigqueryconnection/ShareConnection.java b/samples/snippets/src/main/java/com/example/bigqueryconnection/ShareConnection.java new file mode 100644 index 00000000..b5ae8315 --- /dev/null +++ b/samples/snippets/src/main/java/com/example/bigqueryconnection/ShareConnection.java @@ -0,0 +1,59 @@ +/* + * Copyright 2020 Google LLC + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.example.bigqueryconnection; + +// [START bigqueryconnection_share_connection] +import com.google.api.resourcenames.ResourceName; +import com.google.cloud.bigquery.connection.v1.ConnectionName; +import com.google.cloud.bigqueryconnection.v1.ConnectionServiceClient; +import com.google.iam.v1.Binding; +import com.google.iam.v1.Policy; +import com.google.iam.v1.SetIamPolicyRequest; +import java.io.IOException; + +// Sample to share connections +public class ShareConnection { + + public static void main(String[] args) throws IOException { + // TODO(developer): Replace these variables before running the sample. + String projectId = "MY_PROJECT_ID"; + String location = "MY_LOCATION"; + String connectionId = "MY_CONNECTION_ID"; + shareConnection(projectId, location, connectionId); + } + + public static void shareConnection(String projectId, String location, String connectionId) + throws IOException { + try (ConnectionServiceClient client = ConnectionServiceClient.create()) { + ResourceName resource = ConnectionName.of(projectId, location, connectionId); + Binding binding = + Binding.newBuilder() + .addMembers("group:example-analyst-group@google.com") + .setRole("roles/bigquery.connectionUser") + .build(); + Policy policy = Policy.newBuilder().addBindings(binding).build(); + SetIamPolicyRequest request = + SetIamPolicyRequest.newBuilder() + .setResource(resource.toString()) + .setPolicy(policy) + .build(); + client.setIamPolicy(request); + System.out.println("Connection shared successfully"); + } + } +} +// [END bigqueryconnection_share_connection] diff --git a/samples/snippets/src/test/java/com/example/bigqueryconnection/ShareConnectionIT.java b/samples/snippets/src/test/java/com/example/bigqueryconnection/ShareConnectionIT.java new file mode 100644 index 00000000..670e2c37 --- /dev/null +++ b/samples/snippets/src/test/java/com/example/bigqueryconnection/ShareConnectionIT.java @@ -0,0 +1,106 @@ +/* + * Copyright 2020 Google LLC + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.example.bigqueryconnection; + +import static com.google.common.truth.Truth.assertThat; +import static junit.framework.TestCase.assertNotNull; + +import com.google.cloud.bigquery.connection.v1.CloudSqlCredential; +import com.google.cloud.bigquery.connection.v1.CloudSqlProperties; +import com.google.cloud.bigquery.connection.v1.Connection; +import java.io.ByteArrayOutputStream; +import java.io.IOException; +import java.io.PrintStream; +import java.util.UUID; +import java.util.logging.Level; +import java.util.logging.Logger; +import org.junit.After; +import org.junit.Before; +import org.junit.BeforeClass; +import org.junit.Test; + +public class ShareConnectionIT { + + private static final Logger LOG = Logger.getLogger(ShareConnectionIT.class.getName()); + private static final String LOCATION = "US"; + private static final String REGION = "us-central1"; + private static final String PROJECT_ID = requireEnvVar("GOOGLE_CLOUD_PROJECT"); + private static final String MY_SQL_DATABASE = requireEnvVar("MY_SQL_DATABASE"); + private static final String MY_SQL_INSTANCE = requireEnvVar("MY_SQL_INSTANCE"); + private static final String DB_USER = requireEnvVar("DB_USER"); + private static final String DB_PWD = requireEnvVar("DB_PWD"); + + private String connectionId; + private ByteArrayOutputStream bout; + private PrintStream out; + private PrintStream originalPrintStream; + + private static String requireEnvVar(String varName) { + String value = System.getenv(varName); + assertNotNull( + "Environment variable " + varName + " is required to perform these tests.", + System.getenv(varName)); + return value; + } + + @BeforeClass + public static void checkRequirements() { + requireEnvVar("GOOGLE_CLOUD_PROJECT"); + requireEnvVar("MY_SQL_DATABASE"); + requireEnvVar("MY_SQL_INSTANCE"); + requireEnvVar("DB_USER"); + requireEnvVar("DB_PWD"); + } + + @Before + public void setUp() throws IOException { + bout = new ByteArrayOutputStream(); + out = new PrintStream(bout); + originalPrintStream = System.out; + System.setOut(out); + // create a temporary connection + connectionId = "MY_CONNECTION_TEST_" + UUID.randomUUID().toString().substring(0, 8); + String instanceId = String.format("%s:%s:%s", PROJECT_ID, REGION, MY_SQL_INSTANCE); + CloudSqlCredential cloudSqlCredential = + CloudSqlCredential.newBuilder().setUsername(DB_USER).setPassword(DB_PWD).build(); + CloudSqlProperties cloudSqlProperties = + CloudSqlProperties.newBuilder() + .setType(CloudSqlProperties.DatabaseType.MYSQL) + .setDatabase(MY_SQL_DATABASE) + .setInstanceId(instanceId) + .setCredential(cloudSqlCredential) + .build(); + Connection connection = Connection.newBuilder().setCloudSql(cloudSqlProperties).build(); + CreateConnection.createConnection(PROJECT_ID, LOCATION, connectionId, connection); + } + + @After + public void tearDown() throws IOException { + // Clean up + DeleteConnection.deleteConnection(PROJECT_ID, LOCATION, connectionId); + // restores print statements in the original method + System.out.flush(); + System.setOut(originalPrintStream); + LOG.log(Level.INFO, bout.toString()); + } + + @Test + public void testShareConnection() throws IOException { + ShareConnection.shareConnection(PROJECT_ID, LOCATION, connectionId); + assertThat(bout.toString()).contains("Connection shared successfully"); + } +}