Administrar 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.

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 la descripción general de los perfiles de conexión.

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

  • Es 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 Perfiles de conexión.

    Ir 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 con 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 para el 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 Perfiles de conexión.

    Ir 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 tiempo 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 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 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 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, de diferencias y completas (que contienen los archivos de registro de transacciones, de copia de seguridad diferencial y de copia de seguridad completa).
  • (Opcional, solo para perfiles de conexión de destino)
    • CLOUDSQL_INSTANCE_ID con el identificador de instancia de tu instancia de Cloud SQL para SQL Server de destino. Para obtener información sobre cómo ver los detalles de la 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 Crea y configura 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 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

Solo puedes borrar un perfil de conexión si no hay trabajos de migración que lo usen. Si quieres borrar un perfil de conexión que está en uso en un trabajo de migración, primero borra todos los trabajos de migració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.

    Ir a Perfiles de conexión

  2. Haz clic en el nombre visible del perfil de conexión que deseas 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 devuelve un mensaje de confirmación interactivo que requiere tu entrada para completarse. Puedes omitir el mensaje de confirmación con la marca --quiet opcional.

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

  • REGION con 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 devuelve 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 confirmaciones interactivas de Google Cloud CLI con la marca opcional --quiet.