Gestionar perfiles de conexión

En esta página se describe cómo realizar operaciones de visualización, actualización y eliminación de perfiles de conexión.

Ver un perfil de conexión

Puedes ver la siguiente información sobre tus perfiles de conexión:

  • Todos los detalles de configuración proporcionados durante la creación del perfil. Para obtener más información, consulta la información general sobre los perfiles de conexión.

  • Hora de creación y última modificación del perfil de conexión.

  • Lista de tareas de migración que usan este perfil de conexión.

Para ver los detalles de un perfil de conexión, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página Perfiles de conexión.

    Ve a Perfiles de conexión

  2. Haga clic en el nombre visible del perfil de conexión que quiera ver.

    Aparecerá una página con la información general del perfil de conexión.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

  • REGION con el identificador de la región en la que se guarda tu perfil de conexión.
  • CONNECTION_PROFILE_ID con el identificador de tu perfil de conexión.

    Si no lo sabes, puedes usar el comando gcloud database-migration connection-profiles list para ver una lista de todos los perfiles de una región determinada y sus identificadores.

Para obtener más información sobre estos valores, consulta el artículo Información general sobre los perfiles de conexión.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud database-migration connection-profiles \
describe CONNECTION_PROFILE_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration connection-profiles `
describe CONNECTION_PROFILE_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
describe CONNECTION_PROFILE_ID ^
  --region=REGION

Actualizar un perfil de conexión

Puede modificar los siguientes detalles del perfil de conexión:

  • Nombre visible
  • (Solo perfil de origen) Nombre del segmento de Cloud Storage
  • (Solo perfil de destino) Identificador de la instancia de Cloud SQL para SQL Server de destino, nombre de usuario y contraseña de la base de datos

Para actualizar un perfil de conexión, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página Perfiles de conexión.

    Ve a Perfiles de conexión

  2. Haga clic en el nombre visible del perfil de conexión que quiera modificar.

    Aparecerá una página de resumen del perfil de conexión.

  3. Haz clic en Editar y actualiza tu perfil de conexión.
  4. Haz clic en Guardar.

gcloud

En este ejemplo se usa la marca opcional --no-async para que todas las operaciones se realicen de forma síncrona. Esto significa que algunos comandos pueden tardar en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si lo haces, debes usar el comando gcloud database-migration operations describe para verificar si la operación se ha realizado correctamente.

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

  • CONNECTION_PROFILE_ID con el identificador de tu perfil de conexión.

    Si no lo sabes, puedes usar el comando gcloud database-migration connection-profiles list para ver una lista de todos los perfiles de una región determinada y sus identificadores.

  • REGION con el identificador de la región en la que se guarda tu perfil de conexión.
  • (Opcional) CONNECTION_PROFILE_NAME con un nombre legible para tu perfil de conexión. Este valor se muestra en la consola Google Cloud .
  • (Opcional, solo para perfiles de conexión de origen) SOURCE_STORAGE_BUCKET_NAME con el nombre del segmento de Cloud Storage que contiene la carpeta de la base de datos superior en la que creas las carpetas full, diff y logs (que contienen los archivos de copia de seguridad completa, copia de seguridad diferencial y registro de transacciones).
  • (Opcional, solo para perfiles de conexión de destino)
    • CLOUDSQL_INSTANCE_ID con el identificador de instancia de Cloud SQL para SQL Server de destino. Para obtener información sobre cómo ver los detalles de una instancia de Cloud SQL, consulta Ver información de la instancia en la documentación de Cloud SQL.
    • Detalles del usuario de migración: proporciona los detalles de la cuenta de usuario de la base de datos dedicada en tu instancia de destino. Para obtener más información sobre esta cuenta de usuario, consulta Crear y configurar la instancia de destino de Cloud SQL para SQL Server.
      • CLOUD_SQL_DB_USERNAME con el nombre de usuario de migración.
      • CLOUD_SQL_DB_USER_PASSWORD con la contraseña de la cuenta de migración.
Para obtener más información sobre estos valores, consulta el artículo Información general sobre los perfiles de conexión.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud database-migration connection-profiles \
create sqlserver CONNECTION_PROFILE_ID \
  --no-async
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --gcs-bucket=SOURCE_STORAGE_BUCKET_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID \
  --username=CLOUD_SQL_DB_USERNAME \
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (PowerShell)

gcloud database-migration connection-profiles `
create sqlserver CONNECTION_PROFILE_ID `
  --no-async
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --gcs-bucket=SOURCE_STORAGE_BUCKET_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID `
  --username=CLOUD_SQL_DB_USERNAME `
  --password=CLOUD_SQL_DB_USER_PASSWORD

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
create sqlserver CONNECTION_PROFILE_ID ^
  --no-async
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --gcs-bucket=SOURCE_STORAGE_BUCKET_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID ^
  --username=CLOUD_SQL_DB_USERNAME ^
  --password=CLOUD_SQL_DB_USER_PASSWORD

Deberías recibir una respuesta similar a la siguiente:

Waiting for connection profile [CONNECTION_PROFILE_ID]
to be updated with [OPERATION_ID]

Waiting for operation [OPERATION_ID] to complete...done.

Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]

Eliminar un perfil de conexión

Solo puedes eliminar un perfil de conexión si no hay ninguna tarea de migración que lo utilice. Si quieres eliminar un perfil de conexión que esté usando una tarea de migración, primero elimina todas las tareas de migración que estén vinculadas al perfil de conexión.

Para eliminar un perfil de conexión, sigue estos pasos:

Consola

  1. En la Google Cloud consola, ve a la página Perfiles de conexión.

    Ve a Perfiles de conexión

  2. Haz clic en el nombre visible del perfil de conexión que quieras eliminar.

    Aparecerá una página con la información general del perfil de conexión.

  3. Haz clic en Eliminar.
  4. En el cuadro de diálogo, haz clic en Eliminar.

gcloud

Este comando devuelve una petición de confirmación interactiva que requiere que introduzcas datos para completarse. Puedes saltarte la petición de confirmación usando la marca opcional --quiet.

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

  • REGION con el identificador de la región en la que se guarda tu perfil de conexión.
  • CONNECTION_PROFILE_ID con el identificador de tu perfil de conexión.

    Si no lo sabes, puedes usar el comando gcloud database-migration connection-profiles list para ver una lista de todos los perfiles de una región determinada y sus identificadores.

Para obtener más información sobre estos valores, consulta el artículo Información general sobre los perfiles de conexión.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud database-migration connection-profiles \
delete CONNECTION_PROFILE_ID \
  --region=REGION

Windows (PowerShell)

gcloud database-migration connection-profiles `
delete CONNECTION_PROFILE_ID `
  --region=REGION

Windows (cmd.exe)

gcloud database-migration connection-profiles ^
delete CONNECTION_PROFILE_ID ^
  --region=REGION
 Resultado

delete devuelve una petición interactiva en la que confirmas la acción. Introduce Y para eliminar el perfil de conexión: 

You are about to delete connection_profile [CONNECTION_PROFILE_ID]

Do you want to continue (Y/n)?
Puedes omitir las peticiones de confirmación interactivas de Google Cloud CLI usando la marca opcional --quiet.