gcloud database-migration conversion-workspaces create Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud database-migration conversion-workspaces create - create a Database Migration Service conversion workspace
- SYNOPSIS
gcloud database-migration conversion-workspaces create(CONVERSION_WORKSPACE:--region=REGION)--destination-database-engine=DESTINATION_DATABASE_ENGINE--source-database-engine=SOURCE_DATABASE_ENGINE[--no-async][--destination-database-provider=DESTINATION_DATABASE_PROVIDER; default="CLOUDSQL"][--destination-database-version=DESTINATION_DATABASE_VERSION; default="unspecified"][--display-name=DISPLAY_NAME][--global-settings=[KEY=VALUE,…]][--source-database-provider=SOURCE_DATABASE_PROVIDER; default="UNSPECIFIED"][--source-database-version=SOURCE_DATABASE_VERSION; default="unspecified"][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
- Create a Database Migration Service conversion workspace.
- EXAMPLES
- To create a conversion workspace:
gclouddatabase-migrationconversion-workspacescreatemy-conversion-workspace--region=us-central1--display-name=cw1--source-database-engine=ORACLE--source-database-version=11--destination-database-engine=POSTGRESQL--destination-database-version=15 - POSITIONAL ARGUMENTS
- Conversion workspace resource - The conversion workspace to create. Thearguments 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 inother ways.
To set the
projectattribute:- provide the argument
conversion_workspaceon the command line witha fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
CONVERSION_WORKSPACE- ID of the conversion_workspace or fully qualified identifier for theconversion_workspace.
To set the
conversion_workspaceattribute:- provide the argument
conversion_workspaceon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--region=REGION- The Cloud region for the conversion_workspace.
To set the
regionattribute:- provide the argument
conversion_workspaceon the command line witha fully specified name; - provide the argument
--regionon the command line.
- provide the argument
- provide the argument
- Conversion workspace resource - The conversion workspace to create. Thearguments 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 inother ways.
- REQUIRED FLAGS
--destination-database-engine=DESTINATION_DATABASE_ENGINE- Destination database engine type.
DESTINATION_DATABASE_ENGINEmust be (only one value issupported):POSTGRESQL. --source-database-engine=SOURCE_DATABASE_ENGINE- Source database engine type.
SOURCE_DATABASE_ENGINEmustbe one of:ORACLE,SQL_SERVER.
- OPTIONAL FLAGS
--no-async- Waits for the operation in progress to complete before returning.
--destination-database-provider=DESTINATION_DATABASE_PROVIDER; default="CLOUDSQL"- Destination database provider.
DESTINATION_DATABASE_PROVIDERmust be one of:ALLOYDB,CLOUDSQL. --destination-database-version=DESTINATION_DATABASE_VERSION; default="unspecified"- Version number for the database engine. The version number must contain numbersand letters only. Example for PostgreSQL 17.0, version number will be 17.0.
--display-name=DISPLAY_NAME- A user-friendly name for the conversion workspace. The display name can includeletters, numbers, spaces, and hyphens, and must start with a letter. The maximumlength allowed is 60 characters.
--global-settings=[KEY=VALUE,…]- A generic list of settings for the workspace. The settings are database pairdependant and can indicate default behavior for the mapping rules engine or turnon or off specific features. An object containing a list of "key": "value"pairs.
--source-database-provider=SOURCE_DATABASE_PROVIDER; default="UNSPECIFIED"- Source database provider.
SOURCE_DATABASE_PROVIDERmustbe one of:AMAZON_RDS,AZURE_MANAGED_INSTANCE,AZURE_SQL_DATABASE,CLOUDSQL,UNSPECIFIED. --source-database-version=SOURCE_DATABASE_VERSION; default="unspecified"- Version number for the database engine. The version number must contain numbersand letters only. Example for Oracle 21c, version number will be 21c.
- 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.
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-06-10 UTC.