1 /* 2 * Copyright 2022 Google LLC 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * https://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 /** 18 * A client to Dataproc Metastore API 19 * 20 * <p>The interfaces provided are listed below, along with usage samples. 21 * 22 * <p>======================= DataprocMetastoreClient ======================= 23 * 24 * <p>Service Description: Configures and manages metastore services. Metastore services are fully 25 * managed, highly available, autoscaled, autohealing, OSS-native deployments of technical metadata 26 * management software. Each metastore service exposes a network endpoint through which metadata 27 * queries are served. Metadata queries can originate from a variety of sources, including Apache 28 * Hive, Apache Presto, and Apache Spark. 29 * 30 * <p>The Dataproc Metastore API defines the following resource model: 31 * 32 * <ul> 33 * <li>The service works with a collection of Google Cloud projects, named: `/projects/*` 34 * <li>Each project has a collection of available locations, named: `/locations/*` (a location 35 * must refer to a Google Cloud `region`) 36 * <li>Each location has a collection of services, named: `/services/*` 37 * <li>Dataproc Metastore services are resources with names of the form: 38 * </ul> 39 * 40 * <p>`/projects/{project_number}/locations/{location_id}/services/{service_id}`. 41 * 42 * <p>Sample for DataprocMetastoreClient: 43 * 44 * <pre>{@code 45 * // This snippet has been automatically generated and should be regarded as a code template only. 46 * // It will require modifications to work: 47 * // - It may require correct/in-range values for request initialization. 48 * // - It may require specifying regional endpoints when creating the service client as shown in 49 * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library 50 * try (DataprocMetastoreClient dataprocMetastoreClient = DataprocMetastoreClient.create()) { 51 * ServiceName name = ServiceName.of("[PROJECT]", "[LOCATION]", "[SERVICE]"); 52 * Service response = dataprocMetastoreClient.getService(name); 53 * } 54 * }</pre> 55 * 56 * <p>======================= DataprocMetastoreFederationClient ======================= 57 * 58 * <p>Service Description: Configures and manages metastore federation services. Dataproc Metastore 59 * Federation Service allows federating a collection of backend metastores like BigQuery, Dataplex 60 * Lakes, and other Dataproc Metastores. The Federation Service exposes a gRPC URL through which 61 * metadata from the backend metastores are served at query time. 62 * 63 * <p>The Dataproc Metastore Federation API defines the following resource model: 64 * 65 * <ul> 66 * <li>The service works with a collection of Google Cloud projects. 67 * <li>Each project has a collection of available locations. 68 * <li>Each location has a collection of federations. 69 * <li>Dataproc Metastore Federations are resources with names of the form: 70 * `projects/{project_number}/locations/{location_id}/federations/{federation_id}`. 71 * </ul> 72 * 73 * <p>Sample for DataprocMetastoreFederationClient: 74 * 75 * <pre>{@code 76 * // This snippet has been automatically generated and should be regarded as a code template only. 77 * // It will require modifications to work: 78 * // - It may require correct/in-range values for request initialization. 79 * // - It may require specifying regional endpoints when creating the service client as shown in 80 * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library 81 * try (DataprocMetastoreFederationClient dataprocMetastoreFederationClient = 82 * DataprocMetastoreFederationClient.create()) { 83 * FederationName name = FederationName.of("[PROJECT]", "[LOCATION]", "[FEDERATION]"); 84 * Federation response = dataprocMetastoreFederationClient.getFederation(name); 85 * } 86 * }</pre> 87 */ 88 @Generated("by gapic-generator-java") 89 package com.google.cloud.metastore.v1; 90 91 import javax.annotation.Generated; 92