gcloud alpha biglake iceberg tables register

NAME
gcloud alpha biglake iceberg tables register - register a BigLake Iceberg table
SYNOPSIS
gcloud alpha biglake iceberg tables register (TABLE : --catalog=CATALOG --namespace=NAMESPACE) --metadata-location=METADATA_LOCATION [--overwrite] [GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) Register a BigLake Iceberg table.
EXAMPLES
To register table my-table in parent catalog my-catalog and namespace my-namespace, run:
gcloud alpha biglake iceberg tables register my-table --namespace=my-namespace --catalog=my-catalog --metadata-location=gs://my-bucket/metadata.json

To overwrite table my-table in parent catalog my-catalog and namespace my-namespace, run:

gcloud alpha biglake iceberg tables register my-table --namespace=my-namespace --catalog=my-catalog --metadata-location=gs://my-bucket/metadata.json --overwrite
POSITIONAL ARGUMENTS
Table resource - The Iceberg Table to register. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument table on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

This must be specified.

TABLE
ID of the table or fully qualified identifier for the table.

To set the table attribute:

  • provide the argument table on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--catalog=CATALOG
The Iceberg Catalog for the resource.

To set the catalog attribute:

  • provide the argument table on the command line with a fully specified name;
  • provide the argument --catalog on the command line.
--namespace=NAMESPACE
The Iceberg Namespace for the resource.

To set the namespace attribute:

  • provide the argument table on the command line with a fully specified name;
  • provide the argument --namespace on the command line.
REQUIRED FLAGS
--metadata-location=METADATA_LOCATION
Metadata location of the table.
OPTIONAL FLAGS
--overwrite
Overwrite the table if it already exists.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES
This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.