Package com.google.cloud.biglake.v1
Class IcebergCatalogServiceGrpc.IcebergCatalogServiceBlockingStub
java.lang.Object
io.grpc.stub.AbstractStub<S>
io.grpc.stub.AbstractBlockingStub<IcebergCatalogServiceGrpc.IcebergCatalogServiceBlockingStub>
com.google.cloud.biglake.v1.IcebergCatalogServiceGrpc.IcebergCatalogServiceBlockingStub
- Enclosing class:
- IcebergCatalogServiceGrpc
public static final class IcebergCatalogServiceGrpc.IcebergCatalogServiceBlockingStub
extends io.grpc.stub.AbstractBlockingStub<IcebergCatalogServiceGrpc.IcebergCatalogServiceBlockingStub>
A stub to allow clients to do limited synchronous rpc calls to service IcebergCatalogService.
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 The API is defined as OpenAPI 3.1.1 spec. 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 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.
-
Nested Class Summary
Nested classes/interfaces inherited from class io.grpc.stub.AbstractStub
io.grpc.stub.AbstractStub.StubFactory<T extends io.grpc.stub.AbstractStub<T>> -
Method Summary
Modifier and TypeMethodDescriptionbuild(io.grpc.Channel channel, io.grpc.CallOptions callOptions) com.google.protobuf.EmptyReturns 204 if the namespace exists, 404 otherwise.com.google.protobuf.EmptyReturns 204 if the table exists, 404 otherwise.Creates the Iceberg REST Catalog.Creates a namespace in the catalog.Creates a table in the namespace.com.google.protobuf.EmptyDeletes the Iceberg REST Catalog.com.google.protobuf.EmptyReturns 204, not 200 on success.com.google.protobuf.EmptyDeletes a table in the namespace.Failover the catalog to a new primary replica region.Returns the Iceberg REST Catalog configuration options.GetIcebergCatalogConfig lists all catalog configuration settings.Gets an Iceberg namespace in the catalog (or checks if it exists, if the method is HEAD).getIcebergTable(GetIcebergTableRequest request) Gets a table in the namespace.Lists the Iceberg REST Catalogs.Lists Iceberg namespaces in the catalog.Lists table identifiers (not *tables*) in the namespace.Loads credentials for a table in the namespace.Register a table using given metadata file location.Update the Iceberg REST Catalog configuration options.Updates namespace properties.This is CommitTable Iceberg API, which maps to `UpdateIcebergTable` in the Google API nomenclature.Methods inherited from class io.grpc.stub.AbstractBlockingStub
newStub, newStubMethods inherited from class io.grpc.stub.AbstractStub
getCallOptions, getChannel, withCallCredentials, withChannel, withCompression, withDeadline, withDeadlineAfter, withDeadlineAfter, withExecutor, withInterceptors, withMaxInboundMessageSize, withMaxOutboundMessageSize, withOnReadyThreshold, withOption, withWaitForReady
-
Method Details
-
build
protected IcebergCatalogServiceGrpc.IcebergCatalogServiceBlockingStub build(io.grpc.Channel channel, io.grpc.CallOptions callOptions) - Specified by:
buildin classio.grpc.stub.AbstractStub<IcebergCatalogServiceGrpc.IcebergCatalogServiceBlockingStub>
-
getIcebergCatalogConfig
GetIcebergCatalogConfig lists all catalog configuration settings. Most importantly it contains the optional `endpoints` field which lists what methods this catalog supports, since we are not supporting all the methods right now. It returns all the methods defined in this service (subject to project config allowlisting). This is not a GCP resource.
-
listIcebergNamespaces
Lists Iceberg namespaces in the catalog. We only support one level of nesting for namespaces.
-
checkIcebergNamespaceExists
Returns 204 if the namespace exists, 404 otherwise.
-
getIcebergNamespace
Gets an Iceberg namespace in the catalog (or checks if it exists, if the method is HEAD).
-
createIcebergNamespace
Creates a namespace in the catalog.
-
deleteIcebergNamespace
Returns 204, not 200 on success.
-
updateIcebergNamespace
Updates namespace properties.
-
listIcebergTableIdentifiers
public ListIcebergTableIdentifiersResponse listIcebergTableIdentifiers(ListIcebergTableIdentifiersRequest request) Lists table identifiers (not *tables*) in the namespace.
-
createIcebergTable
Creates a table in the namespace.
-
checkIcebergTableExists
Returns 204 if the table exists, 404 otherwise. This is a `HEAD` HTTP method.
-
deleteIcebergTable
Deletes a table in the namespace.
-
getIcebergTable
Gets a table in the namespace.
-
loadIcebergTableCredentials
public LoadIcebergTableCredentialsResponse loadIcebergTableCredentials(GetIcebergTableRequest request) Loads credentials for a table in the namespace.
-
updateIcebergTable
This is CommitTable Iceberg API, which maps to `UpdateIcebergTable` in the Google API nomenclature.
-
registerIcebergTable
Register a table using given metadata file location.
-
getIcebergCatalog
Returns the Iceberg REST Catalog configuration options.
-
listIcebergCatalogs
Lists the Iceberg REST Catalogs.
-
deleteIcebergCatalog
Deletes the Iceberg REST Catalog. Delete does not delete a catalog that has contents -- at least one namespace. Delete is not supported for all catalog types.
-
updateIcebergCatalog
Update the Iceberg REST Catalog configuration options.
-
createIcebergCatalog
Creates the Iceberg REST Catalog. Currently only supports Google Cloud Storage Bucket catalogs. Google Cloud Storage Bucket catalog id is the bucket for which the catalog is created (e.g. `my-catalog` for `gs://my-catalog`). If the bucket does not exist, of the caller does not have bucket metadata permissions, the catalog will not be created.
-
failoverIcebergCatalog
Failover the catalog to a new primary replica region.
-