.TH "GCLOUD_ALPHA_METASTORE_SERVICES_IMPORT_GCS" 1



.SH "NAME"
.HP
gcloud alpha metastore services import gcs \- import metadata into a Dataproc Metastore service from Google Cloud Storage



.SH "SYNOPSIS"
.HP
\f5gcloud alpha metastore services import gcs\fR (\fISERVICE\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) \fB\-\-database\-dump\fR=\fIDATABASE_DUMP\fR \fB\-\-import\-id\fR=\fIIMPORT_ID\fR [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-dump\-type\fR=\fIDUMP_TYPE\fR;\ default="mysql"] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Import metadata into a Dataproc Metastore service from Google
Cloud Storage.

If run asynchronously with \f5\-\-async\fR, exits after printing the operation
name that can be used to poll the status of the export via:

.RS 2m
gcloud metastore operations describe
.RE



.SH "EXAMPLES"

To import metadata with the name \f5my\-import\fR and description \f5testing
description\fR into service \f5my\-service\fR from a database dump with uri
\f5gs://database\-dump\fR and database type \f5mysql\fR, run:

.RS 2m
$ gcloud alpha metastore services import gcs my\-service \e
  \-\-import\-id=my\-import \-\-description='testing description' \e
  \-\-dump\-type=mysql \-\-database\-dump=gs://database\-dump
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Service resource \- Arguments and flags that specify the Dataproc Metastore
service you want to import. 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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5service\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fISERVICE\fR

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

To set the \f5service\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5service\fR on the command line.
.RE
.sp

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

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

The location of the Dataproc Metastore service.

If not specified, will use \f5default\fR metastore/location.


To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5service\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
set the property \f5metastore/location\fR.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-database\-dump\fR=\fIDATABASE_DUMP\fR

A Cloud Storage object URI that specifies a database dump from which to import
metadata. It must begin with \f5gs://\fR.

.TP 2m
\fB\-\-import\-id\fR=\fIIMPORT_ID\fR

The ID of this metadata import.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

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

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

The description of this metadata import.

.TP 2m
\fB\-\-dump\-type\fR=\fIDUMP_TYPE\fR; default="mysql"

The type of the database dump;. If unspecified, defaults to \f5mysql\fR.
\fIDUMP_TYPE\fR must be one of:

.RS 2m
.TP 2m
\fBavro\fR
Database dump contains AVRO files.

.TP 2m
\fBmysql\fR
Database dump is a MYSQL dump file.

.RE
.sp



.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

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



.SH "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:

.RS 2m
$ gcloud metastore services import gcs
.RE

.RS 2m
$ gcloud beta metastore services import gcs
.RE