mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-21 14:39:15 +00:00
gcloud: Tue Mar 1 04:29:52 UTC 2022
This commit is contained in:
Automated
parent
aab53307a8
commit
1456dab6c7
9791 changed files with 814712 additions and 0 deletions
209
gcloud/metastore/services/update
Normal file
209
gcloud/metastore/services/update
Normal file
|
|
@ -0,0 +1,209 @@
|
|||
NAME
|
||||
gcloud metastore services update - update a Dataproc Metastore service
|
||||
|
||||
SYNOPSIS
|
||||
gcloud metastore services update (SERVICE : --location=LOCATION) [--async]
|
||||
[--port=PORT] [--tier=TIER] [--update-labels=[KEY=VALUE,...]]
|
||||
[--clear-labels | --remove-labels=[KEY,...]]
|
||||
[--kerberos-principal=KERBEROS_PRINCIPAL
|
||||
--keytab=KEYTAB --krb5-config=KRB5_CONFIG]
|
||||
[--maintenance-window-day=MAINTENANCE_WINDOW_DAY
|
||||
--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR]
|
||||
[--update-hive-metastore-configs-from-file=UPDATE_HIVE_METASTORE_CONFIGS_FROM_FILE | --update-hive-metastore-configs=[UPDATE_HIVE_METASTORE_CONFIGS,
|
||||
...] --clear-hive-metastore-configs
|
||||
| --remove-hive-metastore-configs=[REMOVE_HIVE_METASTORE_CONFIGS,
|
||||
...]] [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
Update the metadata and/or configuration parameters of a Dataproc Metastore
|
||||
service.
|
||||
|
||||
If run asynchronously with --async, exits after printing one operation name
|
||||
that can be used to poll the status of the update via:
|
||||
|
||||
gcloud metastore operations describe
|
||||
|
||||
EXAMPLES
|
||||
To update a Dataproc Metastore service with the name my-metastore-service
|
||||
to have the port number 8080, and add the two labels, env and foo, run:
|
||||
|
||||
$ gcloud metastore services update my-metastore-service \
|
||||
--port=8080 --update-labels=env=test,foo=bar
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
Service resource - Arguments and flags that specify the Dataproc Metastore
|
||||
service you want to update. 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 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.
|
||||
|
||||
FLAGS
|
||||
--async
|
||||
Return immediately, without waiting for the operation in progress to
|
||||
complete.
|
||||
|
||||
--port=PORT
|
||||
The TCP port on which the Metastore service will listen.
|
||||
|
||||
--tier=TIER
|
||||
The tier of the service. TIER must be one of:
|
||||
|
||||
developer
|
||||
The developer tier provides limited scalability and no fault
|
||||
tolerance. Good for low-cost proof-of-concept.
|
||||
|
||||
enterprise
|
||||
The enterprise tier provides multi-zone high availability, and
|
||||
sufficient scalability for enterprise-level Dataproc Metastore
|
||||
workloads.
|
||||
|
||||
--update-labels=[KEY=VALUE,...]
|
||||
List of label KEY=VALUE pairs to update. If a label exists, its value
|
||||
is modified. Otherwise, a new label is created.
|
||||
|
||||
Keys must start with a lowercase character and contain only hyphens
|
||||
(-), underscores (_), lowercase characters, and numbers. Values must
|
||||
contain only hyphens (-), underscores (_), lowercase characters, and
|
||||
numbers.
|
||||
|
||||
At most one of these can be specified:
|
||||
|
||||
--clear-labels
|
||||
Remove all labels. If --update-labels is also specified then
|
||||
--clear-labels is applied first.
|
||||
|
||||
For example, to remove all labels:
|
||||
|
||||
$ gcloud metastore services update --clear-labels
|
||||
|
||||
To remove all existing labels and create two new labels, foo and baz:
|
||||
|
||||
$ gcloud metastore services update --clear-labels \
|
||||
--update-labels foo=bar,baz=qux
|
||||
|
||||
--remove-labels=[KEY,...]
|
||||
List of label keys to remove. If a label does not exist it is
|
||||
silently ignored. If --update-labels is also specified then
|
||||
--update-labels is applied first.
|
||||
|
||||
Information used to configure the Hive metastore service as a service
|
||||
principal in a Kerberos realm.
|
||||
|
||||
--kerberos-principal=KERBEROS_PRINCIPAL
|
||||
A Kerberos principal that exists in the KDC to authenticate as. A
|
||||
typical principal is of the form "primary/instance@REALM", but there
|
||||
is no exact format.
|
||||
|
||||
--keytab=KEYTAB
|
||||
A Kerberos keytab file that can be used to authenticate a service
|
||||
principal with a Kerberos Key Distribution Center. This is a Secret
|
||||
Manager secret version, and can be fully-qualified URL, or relative
|
||||
name in the form
|
||||
projects/{project_id}/secrets/{secret_id}/versions/{version_id}.
|
||||
|
||||
--krb5-config=KRB5_CONFIG
|
||||
A Cloud Storage URI that specifies the path to a krb5.conf file. It
|
||||
is of the form gs://{bucket_name}/path/krb5.conf, although the file
|
||||
does not need to be named krb5.conf explicitly.
|
||||
|
||||
The one hour maintenance window that specifies when Dataproc Metastore may
|
||||
perform system maintenance operation to the service, in UTC time.
|
||||
|
||||
--maintenance-window-day=MAINTENANCE_WINDOW_DAY
|
||||
The day of week when the window starts, e.g., sun.
|
||||
MAINTENANCE_WINDOW_DAY must be one of: fri, mon, sat, sun, thu, tue,
|
||||
wed.
|
||||
|
||||
This flag must be specified if any of the other arguments in this
|
||||
group are specified.
|
||||
|
||||
--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR
|
||||
The hour of day (0-23) when the window starts.
|
||||
|
||||
This flag must be specified if any of the other arguments in this
|
||||
group are specified.
|
||||
|
||||
Configuration properties specific to running Hive metastore software as
|
||||
the metastore service.
|
||||
|
||||
At most one of these can be specified:
|
||||
|
||||
--update-hive-metastore-configs-from-file=UPDATE_HIVE_METASTORE_CONFIGS_FROM_FILE
|
||||
Path to a XML file containing a mapping of Hive metastore
|
||||
configuration key-value pairs to apply to the Hive metastore.
|
||||
|
||||
For example:
|
||||
|
||||
hive-site.xml
|
||||
<configuration>
|
||||
<property>
|
||||
<name>hive.metastore.warehouse.dir</name>
|
||||
<value>${test.warehouse.dir}</value>
|
||||
<description></description>
|
||||
</property>
|
||||
</configuration>
|
||||
|
||||
Modify the Hive metastore configuration properties by passing
|
||||
key-value pairs in through the flags.
|
||||
|
||||
--update-hive-metastore-configs=[UPDATE_HIVE_METASTORE_CONFIGS,...]
|
||||
Comma-separated list of Hive metastore configurations. Each
|
||||
configuration has the form "NAME=VALUE".
|
||||
|
||||
At most one of these can be specified:
|
||||
|
||||
--clear-hive-metastore-configs
|
||||
clear existing Hive metastore configurations. If
|
||||
--update-hive-metastore-configs is also specified, then
|
||||
--clear-hive-metastore-configs is applied first.
|
||||
|
||||
--remove-hive-metastore-configs=[REMOVE_HIVE_METASTORE_CONFIGS,...]
|
||||
Comma-separated list of configuration keys to remove with the
|
||||
form "KEY1, KEY2". If a label does not exist it is silently
|
||||
ignored. If --update-hive-metastore-configs is also specified,
|
||||
then --remove-hive-metastore-configs is applied first.
|
||||
|
||||
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 update
|
||||
|
||||
$ gcloud beta metastore services update
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue