gcloud datastore import

NAME

gcloud datastore import - import Cloud Datastore entities from Google Cloud Storage

SYNOPSIS

gcloud datastore import INPUT_URL [--async] [--kinds=[KIND,…]] [--namespaces=[NAMESPACE,…]] [--operation-labels=[OPERATION_LABEL,…]] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

Imports entities into Google Cloud Datastore. Existing entities with the same key are overwritten. The import occurs in the background and its progress can be monitored and managed via the Operation resource that is created. If an Import operation is cancelled, it is possible that a subset of the data has already been imported to Cloud Datastore. This data will not be removed.

EXAMPLES

To import all data exported to the output URL gs://exampleBucket/exampleExport/exampleExport.overall_export_metadata, run:

gcloud datastore import gs://exampleBucket/exampleExport/exampleExport.overall_export_metadata

To import all data exported to the output URL gs://exampleBucket/exampleExport/exampleExport.overall_export_metadata without waiting for the operation to complete, run:

gcloud datastore import gs://exampleBucket/exampleExport/exampleExport.overall_export_metadata --async

To import only the exampleKind from the data exported to the output URL gs://exampleBucket/exampleExport/exampleExport.overall_export_metadata, run:

gcloud datastore import gs://exampleBucket/exampleExport/exampleExport.overall_export_metadata --kinds='exampleKind'

POSITIONAL ARGUMENTS

INPUT_URL

Location of the import metadata. Must be a valid Google Cloud Storage object. The file extension is 'overall_export_metadata'.

This location is the 'output_url' field of a previous export, and can be found via the 'operations describe' command.

FLAGS

--async

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

--kinds=[KIND,…]

A list specifying what kinds will be included in the operation. When omitted, all Kinds are included. For example, to operate on only the 'Customer' and 'Order' Kinds:

gcloud datastore import --kinds='Customer','Order'

--namespaces=[NAMESPACE,…]

A list specifying what namespaces will be included in the operation. When omitted, all namespaces are included in the operation, including the default namespace. To specify that only the default namespace should be operated on, use the special symbol '(default)'. For example, to operate on entities from both the 'customers' and default namespaces:

gcloud datastore import --namespaces='(default)','customers'

--operation-labels=[OPERATION_LABEL,…]

A string:string map of custom labels to associate with this operation. For example:

gcloud datastore import --operation-labels=comment='customer orders','sales rep'=pending

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 datastore import

gcloud beta datastore import