Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions generation_config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -366,6 +366,7 @@ libraries:
used for querying Apache Iceberg tables in BigQuery.
GAPICs:
- proto_path: google/cloud/bigquery/biglake/v1
- proto_path: google/cloud/biglake/v1
- proto_path: google/cloud/bigquery/biglake/v1alpha1

- api_shortname: analyticshub
Expand Down
10 changes: 9 additions & 1 deletion java-biglake/.OwlBot-hermetic.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,14 @@ deep-copy-regex:
dest: "/owl-bot-staging/java-biglake/$1/google-cloud-biglake/src"
- source: "/google/cloud/bigquery/biglake/(v.*)/.*-java/samples/snippets/generated"
dest: "/owl-bot-staging/java-biglake/$1/samples/snippets/generated"
- source: "/google/cloud/biglake/(v.*)/.*-java/proto-google-.*/src"
dest: "/owl-bot-staging/java-biglake/$1/proto-google-cloud-biglake-$1/src"
- source: "/google/cloud/biglake/(v.*)/.*-java/grpc-google-.*/src"
dest: "/owl-bot-staging/java-biglake/$1/grpc-google-cloud-biglake-$1/src"
- source: "/google/cloud/biglake/(v.*)/.*-java/gapic-google-.*/src"
dest: "/owl-bot-staging/java-biglake/$1/google-cloud-biglake/src"
- source: "/google/cloud/biglake/(v.*)/.*-java/samples/snippets/generated"
dest: "/owl-bot-staging/java-biglake/$1/samples/snippets/generated"


api-name: biglake
api-name: biglake

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -0,0 +1,273 @@
/*
* Copyright 2025 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
*
* https://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.google.cloud.biglake.v1;

import static com.google.cloud.biglake.v1.IcebergCatalogServiceClient.ListIcebergCatalogsPagedResponse;

import com.google.api.core.ApiFunction;
import com.google.api.core.BetaApi;
import com.google.api.gax.core.GoogleCredentialsProvider;
import com.google.api.gax.core.InstantiatingExecutorProvider;
import com.google.api.gax.grpc.InstantiatingGrpcChannelProvider;
import com.google.api.gax.httpjson.InstantiatingHttpJsonChannelProvider;
import com.google.api.gax.rpc.ApiClientHeaderProvider;
import com.google.api.gax.rpc.ClientContext;
import com.google.api.gax.rpc.ClientSettings;
import com.google.api.gax.rpc.PagedCallSettings;
import com.google.api.gax.rpc.TransportChannelProvider;
import com.google.api.gax.rpc.UnaryCallSettings;
import com.google.cloud.biglake.v1.stub.IcebergCatalogServiceStubSettings;
import java.io.IOException;
import java.util.List;
import javax.annotation.Generated;

// AUTO-GENERATED DOCUMENTATION AND CLASS.
/**
* Settings class to configure an instance of {@link IcebergCatalogServiceClient}.
*
* <p>The default instance has everything set to sensible defaults:
*
* <ul>
* <li>The default service address (biglake.googleapis.com) and default port (443) are used.
* <li>Credentials are acquired automatically through Application Default Credentials.
* <li>Retries are configured for idempotent methods but not for non-idempotent methods.
* </ul>
*
* <p>The builder of this class is recursive, so contained classes are themselves builders. When
* build() is called, the tree of builders is called to create the complete settings object.
*
* <p>For example, to set the
* [RetrySettings](https://cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings)
* of getIcebergCatalog:
*
* <pre>{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* IcebergCatalogServiceSettings.Builder icebergCatalogServiceSettingsBuilder =
* IcebergCatalogServiceSettings.newBuilder();
* icebergCatalogServiceSettingsBuilder
* .getIcebergCatalogSettings()
* .setRetrySettings(
* icebergCatalogServiceSettingsBuilder
* .getIcebergCatalogSettings()
* .getRetrySettings()
* .toBuilder()
* .setInitialRetryDelayDuration(Duration.ofSeconds(1))
* .setInitialRpcTimeoutDuration(Duration.ofSeconds(5))
* .setMaxAttempts(5)
* .setMaxRetryDelayDuration(Duration.ofSeconds(30))
* .setMaxRpcTimeoutDuration(Duration.ofSeconds(60))
* .setRetryDelayMultiplier(1.3)
* .setRpcTimeoutMultiplier(1.5)
* .setTotalTimeoutDuration(Duration.ofSeconds(300))
* .build());
* IcebergCatalogServiceSettings icebergCatalogServiceSettings =
* icebergCatalogServiceSettingsBuilder.build();
* }</pre>
*
* Please refer to the [Client Side Retry
* Guide](https://github.com/googleapis/google-cloud-java/blob/main/docs/client_retries.md) for
* additional support in setting retries.
*/
@Generated("by gapic-generator-java")
public class IcebergCatalogServiceSettings extends ClientSettings<IcebergCatalogServiceSettings> {

/** Returns the object with the settings used for calls to getIcebergCatalog. */
public UnaryCallSettings<GetIcebergCatalogRequest, IcebergCatalog> getIcebergCatalogSettings() {
return ((IcebergCatalogServiceStubSettings) getStubSettings()).getIcebergCatalogSettings();
}

/** Returns the object with the settings used for calls to listIcebergCatalogs. */
public PagedCallSettings<
ListIcebergCatalogsRequest, ListIcebergCatalogsResponse, ListIcebergCatalogsPagedResponse>
listIcebergCatalogsSettings() {
return ((IcebergCatalogServiceStubSettings) getStubSettings()).listIcebergCatalogsSettings();
}

/** Returns the object with the settings used for calls to updateIcebergCatalog. */
public UnaryCallSettings<UpdateIcebergCatalogRequest, IcebergCatalog>
updateIcebergCatalogSettings() {
return ((IcebergCatalogServiceStubSettings) getStubSettings()).updateIcebergCatalogSettings();
}

/** Returns the object with the settings used for calls to createIcebergCatalog. */
public UnaryCallSettings<CreateIcebergCatalogRequest, IcebergCatalog>
createIcebergCatalogSettings() {
return ((IcebergCatalogServiceStubSettings) getStubSettings()).createIcebergCatalogSettings();
}

/** Returns the object with the settings used for calls to failoverIcebergCatalog. */
public UnaryCallSettings<FailoverIcebergCatalogRequest, FailoverIcebergCatalogResponse>
failoverIcebergCatalogSettings() {
return ((IcebergCatalogServiceStubSettings) getStubSettings()).failoverIcebergCatalogSettings();
}

public static final IcebergCatalogServiceSettings create(IcebergCatalogServiceStubSettings stub)
throws IOException {
return new IcebergCatalogServiceSettings.Builder(stub.toBuilder()).build();
}

/** Returns a builder for the default ExecutorProvider for this service. */
public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() {
return IcebergCatalogServiceStubSettings.defaultExecutorProviderBuilder();
}

/** Returns the default service endpoint. */
public static String getDefaultEndpoint() {
return IcebergCatalogServiceStubSettings.getDefaultEndpoint();
}

/** Returns the default service scopes. */
public static List<String> getDefaultServiceScopes() {
return IcebergCatalogServiceStubSettings.getDefaultServiceScopes();
}

/** Returns a builder for the default credentials for this service. */
public static GoogleCredentialsProvider.Builder defaultCredentialsProviderBuilder() {
return IcebergCatalogServiceStubSettings.defaultCredentialsProviderBuilder();
}

/** Returns a builder for the default gRPC ChannelProvider for this service. */
public static InstantiatingGrpcChannelProvider.Builder defaultGrpcTransportProviderBuilder() {
return IcebergCatalogServiceStubSettings.defaultGrpcTransportProviderBuilder();
}

/** Returns a builder for the default REST ChannelProvider for this service. */
@BetaApi
public static InstantiatingHttpJsonChannelProvider.Builder
defaultHttpJsonTransportProviderBuilder() {
return IcebergCatalogServiceStubSettings.defaultHttpJsonTransportProviderBuilder();
}

public static TransportChannelProvider defaultTransportChannelProvider() {
return IcebergCatalogServiceStubSettings.defaultTransportChannelProvider();
}

public static ApiClientHeaderProvider.Builder defaultApiClientHeaderProviderBuilder() {
return IcebergCatalogServiceStubSettings.defaultApiClientHeaderProviderBuilder();
}

/** Returns a new gRPC builder for this class. */
public static Builder newBuilder() {
return Builder.createDefault();
}

/** Returns a new REST builder for this class. */
public static Builder newHttpJsonBuilder() {
return Builder.createHttpJsonDefault();
}

/** Returns a new builder for this class. */
public static Builder newBuilder(ClientContext clientContext) {
return new Builder(clientContext);
}

/** Returns a builder containing all the values of this settings class. */
public Builder toBuilder() {
return new Builder(this);
}

protected IcebergCatalogServiceSettings(Builder settingsBuilder) throws IOException {
super(settingsBuilder);
}

/** Builder for IcebergCatalogServiceSettings. */
public static class Builder
extends ClientSettings.Builder<IcebergCatalogServiceSettings, Builder> {

protected Builder() throws IOException {
this(((ClientContext) null));
}

protected Builder(ClientContext clientContext) {
super(IcebergCatalogServiceStubSettings.newBuilder(clientContext));
}

protected Builder(IcebergCatalogServiceSettings settings) {
super(settings.getStubSettings().toBuilder());
}

protected Builder(IcebergCatalogServiceStubSettings.Builder stubSettings) {
super(stubSettings);
}

private static Builder createDefault() {
return new Builder(IcebergCatalogServiceStubSettings.newBuilder());
}

private static Builder createHttpJsonDefault() {
return new Builder(IcebergCatalogServiceStubSettings.newHttpJsonBuilder());
}

public IcebergCatalogServiceStubSettings.Builder getStubSettingsBuilder() {
return ((IcebergCatalogServiceStubSettings.Builder) getStubSettings());
}

/**
* Applies the given settings updater function to all of the unary API methods in this service.
*
* <p>Note: This method does not support applying settings to streaming methods.
*/
public Builder applyToAllUnaryMethods(
ApiFunction<UnaryCallSettings.Builder<?, ?>, Void> settingsUpdater) {
super.applyToAllUnaryMethods(
getStubSettingsBuilder().unaryMethodSettingsBuilders(), settingsUpdater);
return this;
}

/** Returns the builder for the settings used for calls to getIcebergCatalog. */
public UnaryCallSettings.Builder<GetIcebergCatalogRequest, IcebergCatalog>
getIcebergCatalogSettings() {
return getStubSettingsBuilder().getIcebergCatalogSettings();
}

/** Returns the builder for the settings used for calls to listIcebergCatalogs. */
public PagedCallSettings.Builder<
ListIcebergCatalogsRequest,
ListIcebergCatalogsResponse,
ListIcebergCatalogsPagedResponse>
listIcebergCatalogsSettings() {
return getStubSettingsBuilder().listIcebergCatalogsSettings();
}

/** Returns the builder for the settings used for calls to updateIcebergCatalog. */
public UnaryCallSettings.Builder<UpdateIcebergCatalogRequest, IcebergCatalog>
updateIcebergCatalogSettings() {
return getStubSettingsBuilder().updateIcebergCatalogSettings();
}

/** Returns the builder for the settings used for calls to createIcebergCatalog. */
public UnaryCallSettings.Builder<CreateIcebergCatalogRequest, IcebergCatalog>
createIcebergCatalogSettings() {
return getStubSettingsBuilder().createIcebergCatalogSettings();
}

/** Returns the builder for the settings used for calls to failoverIcebergCatalog. */
public UnaryCallSettings.Builder<FailoverIcebergCatalogRequest, FailoverIcebergCatalogResponse>
failoverIcebergCatalogSettings() {
return getStubSettingsBuilder().failoverIcebergCatalogSettings();
}

@Override
public IcebergCatalogServiceSettings build() throws IOException {
return new IcebergCatalogServiceSettings(this);
}
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
{
"schema": "1.0",
"comment": "This file maps proto services/RPCs to the corresponding library clients/methods",
"language": "java",
"protoPackage": "google.cloud.biglake.v1",
"libraryPackage": "com.google.cloud.biglake.v1",
"services": {
"IcebergCatalogService": {
"clients": {
"grpc": {
"libraryClient": "IcebergCatalogServiceClient",
"rpcs": {
"CreateIcebergCatalog": {
"methods": ["createIcebergCatalog", "createIcebergCatalog", "createIcebergCatalog", "createIcebergCatalogCallable"]
},
"FailoverIcebergCatalog": {
"methods": ["failoverIcebergCatalog", "failoverIcebergCatalog", "failoverIcebergCatalogCallable"]
},
"GetIcebergCatalog": {
"methods": ["getIcebergCatalog", "getIcebergCatalog", "getIcebergCatalog", "getIcebergCatalogCallable"]
},
"ListIcebergCatalogs": {
"methods": ["listIcebergCatalogs", "listIcebergCatalogs", "listIcebergCatalogs", "listIcebergCatalogsPagedCallable", "listIcebergCatalogsCallable"]
},
"UpdateIcebergCatalog": {
"methods": ["updateIcebergCatalog", "updateIcebergCatalog", "updateIcebergCatalogCallable"]
}
}
}
}
}
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
/*
* Copyright 2025 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
*
* https://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.
*/

/**
* A client to BigLake API
*
* <p>The interfaces provided are listed below, along with usage samples.
*
* <p>======================= IcebergCatalogServiceClient =======================
*
* <p>Service Description: Iceberg Catalog Service API: this implements the open-source Iceberg REST
* Catalog API. See the API definition here:
* https://github.com/apache/iceberg/blob/main/open-api/rest-catalog-open-api.yaml
*
* <p>The API is defined as OpenAPI 3.1.1 spec.
*
* <p>Currently we only support the following methods: - GetConfig/GetIcebergCatalogConfig -
* ListIcebergNamespaces - CheckIcebergNamespaceExists - GetIcebergNamespace -
* CreateIcebergNamespace (only supports single level) - DeleteIcebergNamespace -
* UpdateIcebergNamespace properties - ListTableIdentifiers - CreateIcebergTable -
* DeleteIcebergTable - GetIcebergTable - UpdateIcebergTable (CommitTable) -
* LoadIcebergTableCredentials - RegisterTable
*
* <p>Users are required to provided the `X-Goog-User-Project` header with the project id or number
* which can be different from the bucket project id. That project will be charged for the API calls
* and the calling user must have access to that project. The caller must have
* `serviceusage.services.use` permission on the project.
*
* <p>Sample for IcebergCatalogServiceClient:
*
* <pre>{@code
* // This snippet has been automatically generated and should be regarded as a code template only.
* // It will require modifications to work:
* // - It may require correct/in-range values for request initialization.
* // - It may require specifying regional endpoints when creating the service client as shown in
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (IcebergCatalogServiceClient icebergCatalogServiceClient =
* IcebergCatalogServiceClient.create()) {
* CatalogName name = CatalogName.of("[PROJECT]", "[CATALOG]");
* IcebergCatalog response = icebergCatalogServiceClient.getIcebergCatalog(name);
* }
* }</pre>
*/
@Generated("by gapic-generator-java")
package com.google.cloud.biglake.v1;

import javax.annotation.Generated;
Loading
Loading