gcloud alpha metastore services alter-table-properties

NAME

gcloud alpha metastore services alter-table-properties - alter metadata table properties

SYNOPSIS

gcloud alpha metastore services alter-table-properties (SERVICE : --location=LOCATION) --properties=[KEY=VALUE,…] --table-name=TABLE_NAME --update-mask=UPDATE_MASK [--async] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

(ALPHA) Alter metadata table properties from a Dataproc Metastore service's underlying metadata store.

If run asynchronously with --async, exits after printing one operation name that can be used to poll the status of the creation via:

gcloud metastore operations describe

EXAMPLES

To alter metadata table properties a and b on table-name databases/{database_id}/tables/{table_id} , use the update-mask properties.a,properties.b , and run:

gcloud alpha metastore services alter-table-properties my-metastore-service --location=us-central1 --table-name=databases/my-database/tables/my-table --update-mask=properties.a,properties.b --properties=a=1,b=2

POSITIONAL ARGUMENTS

Service resource - Arguments and flags that specify the table you want to alter. 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 service 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.

SERVICE

ID of the service or fully qualified identifier for the service.

To set the service attribute:

• provide the argument service on the command line.

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

--location=LOCATION

The location of the Dataproc Metastore service.

If not specified, will use default metastore/location. To set the location attribute:

• provide the argument service on the command line with a fully specified name;
• provide the argument --location on the command line;
• set the property metastore/location.

REQUIRED FLAGS

--properties=[KEY=VALUE,…]

A string where field names are separated by a comma. Describes the desired values to mutate. If update-mask is empty, the properties will not update. Otherwise, the properties only alter the values whose associated paths exist in the update mask.

For example, the desired key-value pairs.

a=2,b=3,c=4

--table-name=TABLE_NAME

The name of the table containing the properties you're altering in the following format.

databases/{database_id}/tables/{table_id}

--update-mask=UPDATE_MASK

A string where field names are separated by a comma. Specifies the metadata table properties fields that are overwritten by the update. Fields specified in the update-mask are relative to the resource (not to the full request). A field is overwritten if it is in the mask.

For example, given the target properties:

properties {
  a: 1
  b: 2
}

And an update properties:

properties {
  a: 2
  b: 3
  c: 4
}

then if the field mask is:

properties.b,properties.c

then the updated result will be:

properties {
  a: 1
  b: 3
  c: 4
}

OPTIONAL FLAGS

--async

Return immediately, without waiting for the operation in progress to complete.

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.

API REFERENCE

This command uses the metastore/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/dataproc-metastore/docs

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. These variants are also available:

gcloud metastore services alter-table-properties

gcloud beta metastore services alter-table-properties