gcloud: Thu Jan 19 00:56:33 UTC 2023

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

@@ -0,0 +1,92 @@
+NAME
+    gcloud beta metastore services alter-metadata-resource-location - alter
+        metadata resource location
+
+SYNOPSIS
+    gcloud beta metastore services alter-metadata-resource-location
+        (SERVICE : --location=LOCATION) --location_uri=LOCATION_URI
+        --resource_name=RESOURCE_NAME [--async] [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) 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 beta 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/v1beta API. The full documentation for this
+    API can be found at: https://cloud.google.com/dataproc-metastore/docs
+
+NOTES
+    This command is currently in beta and might change without notice. This
+    variant is also available:
+
+        $ gcloud alpha metastore services alter-metadata-resource-location
+

gcloud/beta/metastore/services/help

@@ -37,6 +37,9 @@ COMMANDS
      add-iam-policy-binding
         (BETA) Add an IAM policy binding to a service.
 
+     alter-metadata-resource-location
+        (BETA) Alter metadata resource location.
+
      create
         (BETA) Create a Dataproc Metastore service.
 
@@ -52,6 +55,13 @@ COMMANDS
      list
         (BETA) List Dataproc Metastore services.
 
+     move-table-to-database
+        (BETA) Move table to another database.
+
+     query-metadata
+        (BETA) Execute a SQL query against a Dataproc Metastore Service's
+        metadata.
+
      remove-iam-policy-binding
         (BETA) Remove an IAM policy binding from a service.
 

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

@@ -0,0 +1,95 @@
+NAME
+    gcloud beta metastore services move-table-to-database - move table to
+        another database
+
+SYNOPSIS
+    gcloud beta 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
+    (BETA) 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 beta 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/v1beta API. The full documentation for this
+    API can be found at: https://cloud.google.com/dataproc-metastore/docs
+
+NOTES
+    This command is currently in beta and might change without notice. This
+    variant is also available:
+
+        $ gcloud alpha metastore services move-table-to-database
+

gcloud/beta/metastore/services/query-metadata

@@ -0,0 +1,79 @@
+NAME
+    gcloud beta metastore services query-metadata - execute a SQL query against
+        a Dataproc Metastore Service's metadata
+
+SYNOPSIS
+    gcloud beta metastore services query-metadata
+        (SERVICE : --location=LOCATION) --query=QUERY [--format=FORMAT]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    (BETA) 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 beta 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
+    This command is currently in beta and might change without notice. This
+    variant is also available:
+
+        $ gcloud alpha metastore services query-metadata
+