gcloud: Wed May 17 10:38:17 UTC 2023

gcloud/metastore/services/alter-metadata-resource-location

@@ -0,0 +1,95 @@
+NAME
+    gcloud metastore services alter-metadata-resource-location - alter metadata
+        resource location
+
+SYNOPSIS
+    gcloud metastore services alter-metadata-resource-location
+        (SERVICE : --location=LOCATION) --location_uri=LOCATION_URI
+        --resource_name=RESOURCE_NAME [--async] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Alter metadata resource location 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 resource location with the resource_name
+    databases/{database_id} or databases/{database_id}/tables/{table_id} or and
+    location_uri in location us-central, run:
+
+        $ gcloud metastore services alter-metadata-resource-location \
+          my-metastore-service --location=us-central1 \
+          --resource_name=databases/my-db \
+          --location_uri=gs://destination_bucket/destination_object
+
+POSITIONAL ARGUMENTS
+     Service resource - Arguments and flags that specify the resource and the
+     location 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;
+      ◆ set the property core/project;
+      ◆ provide the argument --project on the command line.
+
+     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
+     --location_uri=LOCATION_URI
+        The new location URI for the metadata resource.
+
+     --resource_name=RESOURCE_NAME
+        The relative metadata resource name in the following format.
+        databases/{database_id} or databases/{database_id}/tables/{table_id} or
+        databases/{database_id}/tables/{table_id}/partitions/{partition_id}
+
+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/v1 API. The full documentation for this API
+    can be found at: https://cloud.google.com/dataproc-metastore/docs
+
+NOTES
+    These variants are also available:
+
+        $ gcloud alpha metastore services alter-metadata-resource-location
+
+        $ gcloud beta metastore services alter-metadata-resource-location
+

gcloud/metastore/services/alter-table-properties

@@ -0,0 +1,137 @@
+NAME
+    gcloud metastore services alter-table-properties - alter metadata table
+        properties
+
+SYNOPSIS
+    gcloud metastore services alter-table-properties
+        (SERVICE : --location=LOCATION) --properties=PROPERTIES
+        --table-name=TABLE_NAME --update-mask=UPDATE_MASK [--async]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    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 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;
+      ◆ set the property core/project;
+      ◆ provide the argument --project on the command line.
+
+     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=PROPERTIES
+        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/v1 API. The full documentation for this API
+    can be found at: https://cloud.google.com/dataproc-metastore/docs
+
+NOTES
+    These variants are also available:
+
+        $ gcloud alpha metastore services alter-table-properties
+
+        $ gcloud beta metastore services alter-table-properties
+

gcloud/metastore/services/help

@@ -30,6 +30,12 @@ COMMANDS
      add-iam-policy-binding
         Add an IAM policy binding to a service.
 
+     alter-metadata-resource-location
+        Alter metadata resource location.
+
+     alter-table-properties
+        Alter metadata table properties.
+
      create
         Create a Dataproc Metastore service.
 
@@ -45,6 +51,12 @@ COMMANDS
      list
         List Dataproc Metastore services.
 
+     move-table-to-database
+        Move table to another database.
+
+     query-metadata
+        Execute a SQL query against a Dataproc Metastore Service's metadata.
+
      remove-iam-policy-binding
         Remove an IAM policy binding from a service.
 

gcloud/metastore/services/move-table-to-database

@@ -0,0 +1,98 @@
+NAME
+    gcloud metastore services move-table-to-database - move table to another
+        database
+
+SYNOPSIS
+    gcloud metastore services move-table-to-database
+        (SERVICE : --location=LOCATION)
+        --destination_db_name=DESTINATION_DB_NAME
+        --source_db_name=SOURCE_DB_NAME --table_name=TABLE_NAME [--async]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Move table to another database 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 move table to database with the table_name, source_db_name, and
+    destination_db_name in location us-central, run:
+
+        $ gcloud metastore services move-table-to-database \
+          my-metastore-service --location=us-central1 \
+          --table_name=table_name_to_move \
+          --source_db_name=database_name_to_move \
+          --destination_db_name=destination_database_name
+
+POSITIONAL ARGUMENTS
+     Service resource - Arguments and flags that specify the table and the
+     destination database you want to move to. 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;
+      ◆ set the property core/project;
+      ◆ provide the argument --project on the command line.
+
+     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
+     --destination_db_name=DESTINATION_DB_NAME
+        The name of the database where the table should be moved.
+
+     --source_db_name=SOURCE_DB_NAME
+        The name of the database where the table resides.
+
+     --table_name=TABLE_NAME
+        The name of the table to be moved.
+
+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/v1 API. The full documentation for this API
+    can be found at: https://cloud.google.com/dataproc-metastore/docs
+
+NOTES
+    These variants are also available:
+
+        $ gcloud alpha metastore services move-table-to-database
+
+        $ gcloud beta metastore services move-table-to-database
+

gcloud/metastore/services/query-metadata

@@ -0,0 +1,83 @@
+NAME
+    gcloud metastore services query-metadata - execute a SQL query against a
+        Dataproc Metastore Service's metadata
+
+SYNOPSIS
+    gcloud metastore services query-metadata (SERVICE : --location=LOCATION)
+        --query=QUERY [--format=FORMAT] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Execute a SQL query against a Dataproc Metastore Service's metadata.
+
+EXAMPLES
+    To query metadata against a Dataproc Metastore service with the name
+    my-metastore-service in location us-central1, and the sql query "show
+    tables;", run:
+
+        $ gcloud metastore services query-metadata my-metastore-service \
+            --location=us-central1 --query="show tables;"
+
+POSITIONAL ARGUMENTS
+     Service resource - The service to query metadata. 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
+          Location to which the service belongs.
+
+          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
+     --query=QUERY
+        Use Google Standard SQL query for Cloud Spanner and MySQL query syntax
+        for Cloud SQL. Cloud Spanner SQL is described at
+        https://cloud.google.com/spanner/docs/query-syntax)"
+
+COMMONLY USED FLAGS
+     --format=FORMAT
+        Sets the format for printing command output resources. The default is a
+        command-specific human-friendly output format. If both core/format and
+        --format are specified, --format takes precedence. --format and
+        core/format both take precedence over core/default_format. The
+        supported formats are limited to: config, csv, default, diff, disable,
+        flattened, get, json, list, multi, none, object, table, text, value,
+        yaml. For more details run $ gcloud topic formats. Run $ gcloud config
+        set --help to see more information about core/format
+
+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
+    These variants are also available:
+
+        $ gcloud alpha metastore services query-metadata
+
+        $ gcloud beta metastore services query-metadata
+