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.

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

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

  • Es una lista de 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 resumen del perfil de conexión.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, haz 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 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 destino) Identificador de la instancia de Cloud SQL para PostgreSQL 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 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 un poco 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, haz 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.
  • Opcional: CONNECTION_PROFILE_NAME por un nombre legible por humanos para tu perfil de conexión. Este valor se muestra en la consola de Google Cloud .
  • Solo para perfiles de conexión de destino: CLOUDSQL_INSTANCE_ID con el identificador de instancia de tu instancia de Cloud SQL de destino. Para obtener información sobre cómo ver los detalles de la instancia de Cloud SQL, consulta Visualiza la información de la instancia en la documentación de Cloud SQL.
Para obtener más información sobre estos valores, consulta Descripción general de los perfiles de conexión.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

gcloud database-migration connection-profiles update postgresql \
  CONNECTION_PROFILE_ID \
  --no-async \
  --region=REGION \
  --display-name=CONNECTION_PROFILE_NAME \
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows (PowerShell)

gcloud database-migration connection-profiles update postgresql `
  CONNECTION_PROFILE_ID `
  --no-async `
  --region=REGION `
  --display-name=CONNECTION_PROFILE_NAME `
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

Windows (cmd.exe)

gcloud database-migration connection-profiles update postgresql ^
  CONNECTION_PROFILE_ID ^
  --no-async ^
  --region=REGION ^
  --display-name=CONNECTION_PROFILE_NAME ^
  --cloudsql-instance=CLOUDSQL_INSTANCE_ID

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.

Updated 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 deseas borrar un perfil de conexión que usa 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 resumen 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 opcional --quiet.

Antes de usar cualquiera de los datos de comando a continuación, haz 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 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 solicitudes de confirmación interactivas de Google Cloud CLI con la marca opcional --quiet.