gcloud alpha datastore export
- NAME
- gcloud alpha datastore export - export Cloud Datastore entities to Google Cloud Storage
- SYNOPSIS
gcloud alpha datastore exportOUTPUT_URL_PREFIX[--async][--kinds=[KIND,…]][--namespaces=[NAMESPACE,…]][--operation-labels=[OPERATION_LABEL,…]][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(ALPHA)Export a copy of all or a subset of entities from GoogleCloud Datastore to another storage system, such as Google Cloud Storage. Recentupdates to entities may not be reflected in the export. The export occurs in thebackground and its progress can be monitored and managed via the operationcommands. The output of an export may only be used once the operation hascompleted. If an export operation is cancelled before completion then it mayleave partial data behind in Google Cloud Storage.- EXAMPLES
- To export all kinds in the
exampleNsnamespace in theexampleProjectproject to theexampleBucket, run:gcloudalphadatastoreexportgs://exampleBucket--namespaces='exampleNs'--project='exampleProject'To export the
exampleKindandotherKindkinds in theexampleNsnamespace in theexampleProjectproject totheexampleBucket, run:gcloudalphadatastoreexportgs://exampleBucket--kinds='exampleKind','otherKind'--namespaces='exampleNs'--project='exampleProject'To export all namespaces and kinds in the currently set project to the
exampleBucketwithout waiting for the operation to complete, run:gcloudalphadatastoreexportgs://exampleBucket--asyncTo export the
exampleKindin all namespaces in the currently setproject to theexampleBucket, and output the result in JSON, run:gcloudalphadatastoreexportgs://exampleBucket--kinds='exampleKind'--format=json - POSITIONAL ARGUMENTS
OUTPUT_URL_PREFIX- Location for the export metadata and data files. Must be a valid Google CloudStorage bucket with an optional path prefix. For example:
gcloudalphadatastoreexportgs://mybucket/my/pathWill place the export in the
mybucketbucket in objects prefixedwithmy/path.
- 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:
gcloudalphadatastoreexport--kinds='Customer','Order' --namespaces=[NAMESPACE,…]- A list specifying what namespaces will be included in the operation. Whenomitted, all namespaces are included in the operation, including the defaultnamespace. To specify that
onlythe default namespace should beoperated on, use the special symbol '(default)'. For example, to operate onentities from both the 'customers' and default namespaces:gcloudalphadatastoreexport--namespaces='(default)','customers' --operation-labels=[OPERATION_LABEL,…]- A string:string map of custom labels to associate with this operation. Forexample:
gcloudalphadatastoreexport--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 helpfor details. - NOTES
- This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gclouddatastoreexportgcloudbetadatastoreexport
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-05-07 UTC.