Administrar perfiles de conexión

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

Cómo 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 Descripción general de los perfiles de conexión.

  • Creación del perfil de conexión y hora de la última modificación

  • Una lista de los trabajos de migración que usan este perfil de conexión.

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

Console

  1. En la consola de Google Cloud , ve a la página Connection profiles.

    Ve a Perfiles de conexión

  2. Haz clic en el nombre visible del perfil de conexión que deseas ver.

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

gcloud

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

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

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

Para obtener más información sobre estos valores, consulta la descripción general de 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

Actualiza un perfil de conexión

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

  • Nombre visible
  • (Solo perfil de origen) Nombre del bucket de Cloud Storage
  • (Solo para el 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:

Console

  1. En la consola de Google Cloud , ve a la página Connection profiles.

    Ve a Perfiles de conexión

  2. Haz clic en el nombre visible del perfil de conexión que deseas modificar.

    Aparecerá una página de descripción general 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 un poco en completarse. Puedes omitir la marca --no-async para ejecutar comandos de forma asíncrona. Si es así, debes usar el comando gcloud database-migration operations describe para verificar si la operación se realizó correctamente.

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

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

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

  • REGION por el identificador de la región en la que se guarda tu perfil de conexión.
  • CONNECTION_PROFILE_NAME (opcional) con un nombre legible por humanos para tu perfil de conexión Este valor se muestra en la consola de Google Cloud .
  • (Opcional, solo para perfiles de conexión de origen) SOURCE_STORAGE_BUCKET_NAME con el nombre del bucket de Cloud Storage que contiene la carpeta de la base de datos principal en la que creas las carpetas de registros, diferencias y completas (que contienen la copia de seguridad completa, la copia de seguridad diferencial y los archivos de registro de transacciones).
  • (Opcional, solo para perfiles de conexión de destino)
    • CLOUDSQL_INSTANCE_ID por el identificador de la instancia de tu destino de Cloud SQL para SQL Server. Para obtener información sobre cómo ver detalles de la instancia de Cloud SQL, consulta Cómo ver la 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 Crea y configura la instancia de destino de Cloud SQL para SQL Server.
      • CLOUD_SQL_DB_USERNAME con el nombre de usuario de la 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 la descripción general de 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 que figura a continuación:

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]

Borrar un perfil de conexión

Puedes borrar un perfil de conexión solo si no hay trabajos de migración que usen ese perfil. Si quieres borrar un perfil de conexión que está en uso por un trabajo de migración, primero borra todos los trabajos de migración que estén vinculados al perfil de conexión.

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

Console

  1. En la consola de Google Cloud , 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 quieres borrar.

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

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

gcloud

Este comando muestra un mensaje de confirmación interactivo que requiere tu entrada para completarse. Puedes omitir el mensaje de confirmación con la marca opcional --quiet.

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

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

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

Para obtener más información sobre estos valores, consulta la descripción general de 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 muestra un mensaje interactivo en el que confirmas la acción. Ingresa Y para quitar 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 indicaciones de confirmación interactivas de Google Cloud CLI con la marca opcional --quiet.