Manage conversion workspaces

This page describes how to manage multiple conversion workspaces in your projects. From the list of conversion workspaces, you can:

Select a specific conversion workspace to access the conversion editor, view and modify workspace details, apply generated schema and code to your destination database, and create a migration job.
Use the Moremenu to delete a workspace.

View conversion workspace details

To view conversion workspace details, use the Conversion workspacespage in the Google Cloud console or Google Cloud CLI.

Console

In the Google Cloud console, go to Conversion workspaces.

Go to Conversion workspaces

From the list of available workspaces, select the one you want to work with.

Conversion workspace editor page appears.
Select Edit configuration > View details.

The Conversion workspace detailspanel opens.

gcloud

List all workspaces available in a particular region to retrieve their identifiers:
```
 gcloud  
database-migration  
conversion-workspaces  
list  
 \ 
  
--region = 
 REGION 
 
```
Replace:
- REGION with the name of the region where the conversion workspace is located.
Example:
```
 gcloud  
database-migration  
conversion-workspaces  
list  
 \ 
  
--region = 
us-central1 
```
The list of available workspaces and their identifiers is printed to standard output.

Retrieve details for a specific workspace:

 gcloud  
database-migration  
conversion-workspaces  
describe  
 CONVERSION_WORKSPACE 
  
 \ 
  
--region = 
 REGION

Replace:

CONVERSION_WORKSPACE with the identifier or the fully qualified name of the conversion workspace
REGION with the name of the region where the conversion workspace is located.

Example:

 gcloud  
database-migration  
conversion-workspaces  
describe  
my-conversion-workspace-id  
 \ 
  
--region = 
us-central1

Modify conversion workspace settings

Information that you can modify for a conversion workspace includes the display name, source connection profile, add or remove custom conversion configuration files.

Go to the Conversion workspacespage in the Google Cloud console:

Go to Conversion workspaces
Click the display name of the conversion workspace that you want to modify.

The conversion workspace editor opens.
Select Edit configuration > View details.

The Conversion workspace detailspanel opens.
To modify the workspace display name:
1. In the Conversion workspace namerow, click the editicon.
2. In the Conversion workspace namefield, enter the new display name for the conversion workspace.
3. Click Save.
To modify the source connection profile:
1. In the Source connection profilerow, click the link to the connection profile associated with the workspace.
2. On the connection profile page, adjust any details as required. For more information, see Manage connection profiles . A new version of the conversion workspace is created and the updated version ID also appears on the overview page. This version can be used with a migration job.
You can also modify what custom conversion mapping files are used in your workspace. For more information, see Use custom conversion mappings .

Delete a conversion workspace

You can delete a conversion workspace only if it's not used by active migration jobs.

To delete a conversion workspace that's linked to active migration jobs, first, delete all active migration jobs that are linked to the conversion workspace. Then, delete the conversion workspace.

In the Google Cloud console, go to Conversion workspaces.

Go to Conversion workspaces
Next to the conversion workspace you want to delete, click More > Delete.
In the dialog confirmation box, click Delete.

Review all conversion workspaces

You can review all conversion workspaces from the page. The list displays a default set of high-level information for each conversion workspace, including:

The conversion workspace display name and ID .
The version ID of the most-recent version of the conversion workspace that's saved. By having multiple versions of a conversion workspace, you can compare objects in each workspace and identify differences between the workspaces. Versioning can also be used for tracking purposes.
The conversion state that represents whether this conversion workspace was used to pull objects from the source and convert them.
Activity indicates if the conversion workspace is in use by one or more active migration jobs, where an active migration job is any migration job that's not in COMPLETED status. The number of jobs next to the status indicates the total number of jobs (both active and inactive) referencing the conversion workspace.
The source and destination database engines (database types) for which the conversion workspace is configured.
When the conversion workspace was created .

Manage conversion workspaces Stay organized with collections Save and categorize content based on your preferences.