Ver información de instancias

En esta página se describe cómo ver información sobre una instancia de Cloud SQL.

Ver información de resumen de la instancia

Puede ver información de resumen sobre las instancias de Cloud SQL mediante la Google Cloud consola, la CLI de gcloud o la API.

Consola

  1. En la Google Cloud consola, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

    Se muestra la siguiente información sobre las instancias de Cloud SQL que tienen habilitado Private Service Connect:

  2. Para ver el estado actual de una instancia, coloca el puntero sobre el icono de estado situado junto al nombre de la instancia.
  3. Para abrir la página Overview (Resumen) de una instancia, haz clic en su nombre.

    En la tarjeta Conectarse a esta instancia, se muestra la siguiente información adicional sobre las instancias de Cloud SQL con Private Service Connect habilitado:

    • Conectividad de IP privada: el estado es Habilitado porque la instancia debe tener una dirección IP interna.
    • Proyectos permitidos: estos proyectos permiten que los puntos finales de Private Service Connect se conecten a la instancia.
    • Vinculación de servicio: la vinculación de servicio de la instancia
    • Conectividad de IP pública: el estado es Inhabilitado porque no se admiten conexiones de IP externa.
  4. Para ver información sobre la conectividad de la instancia, haz clic en la pestaña Conexiones. Para obtener más información sobre esta pestaña, consulta Acerca de las opciones de conexión.

  5. Haz clic en la pestaña Redes. Se muestra la siguiente información sobre las instancias en las que está habilitado Private Service Connect:

    • La casilla IP privada está seleccionada, pero desactivada. La instancia debe tener una dirección IP interna y este ajuste no se puede cambiar.
    • Los proyectos permitidos de la instancia.
    • La casilla IP pública está marcada, pero desactivada.
    • El campo Redes autorizadas está desactivado porque la instancia usa Private Service Connect, que no admite esta función.

gcloud

Para obtener información sobre cómo instalar y empezar a usar la CLI de gcloud, consulta el artículo Instalar la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta el artículo Usar Cloud Shell.

  1. Para ver información de resumen sobre una instancia, usa el comando gcloud sql instances describe:

    gcloud sql instances describe INSTANCE_NAME \
    --project=PROJECT_ID

    Haz las siguientes sustituciones:

    Este es un ejemplo del resultado de ejecutar este comando:

    gcloud sql instances describe myinstance \
    --project=12345
    ...
    dnsName: mydnsname
    ...
    pscServiceAttachmentLink: projects/myproject/regions/myregion/serviceAttachments/myserviceattachment
    ...
     settings:
      ...
      ipConfiguration:
      ipv4Enabled: false
      pscConfig:
        allowedConsumerProjects:
          - projects/23456
          - projects/34567
        pscEnabled: true
  2. Para ver información más detallada sobre las instancias en las que Private Service Connect está habilitado, añada los siguientes parámetros:
  3. Ajuste Parámetro Notas
    Nombre de DNS dnsName El nombre de DNS de la instancia. Te recomendamos que crees un registro DNS con este nombre y lo dirijas a la dirección IP del punto final de Private Service Connect. También te recomendamos que uses este nombre para conectarte a la instancia.
    Vinculación de servicio pscServiceAttachmentLink URI que apunta al archivo adjunto de servicio de la instancia. Usa este URI para crear el endpoint de Private Service Connect.
    Proyectos de consumidor permitidos allowedConsumerProjects Lista de proyectos permitidos de la instancia. Puedes crear endpoints de Private Service Connect desde cualquier red de VPC de estos proyectos hasta la vinculación de servicio de la instancia.
    Habilitar Private Service Connect pscEnabled Indica si una instancia tiene habilitado Private Service Connect.

Terraform

Para crear una instancia, usa un recurso de Terraform.

Aplica los cambios

Para aplicar la configuración de Terraform en un proyecto, sigue los pasos que se indican en las siguientes secciones. Google Cloud

Preparar Cloud Shell

  1. Abre Cloud Shell.
  2. Define el Google Cloud proyecto Google Cloud predeterminado en el que quieras aplicar tus configuraciones de Terraform.

    Solo tiene que ejecutar este comando una vez por proyecto y puede hacerlo en cualquier directorio.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Las variables de entorno se anulan si defines valores explícitos en el archivo de configuración de Terraform.

Preparar el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).

  1. En Cloud Shell, crea un directorio y un archivo nuevo en ese directorio. El nombre del archivo debe tener la extensión .tf. Por ejemplo, main.tf. En este tutorial, nos referiremos al archivo como main.tf.
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf
  2. Si estás siguiendo un tutorial, puedes copiar el código de ejemplo de cada sección o paso.

    Copia el código de ejemplo en el archivo main.tf que acabas de crear.

    También puedes copiar el código de GitHub. Se recomienda cuando el fragmento de Terraform forma parte de una solución integral.

  3. Revisa y modifica los parámetros de ejemplo para aplicarlos a tu entorno.
  4. Guarda los cambios.
  5. Inicializa Terraform. Solo tienes que hacerlo una vez por directorio.
    terraform init

    Si quieres usar la versión más reciente del proveedor de Google, incluye la opción -upgrade:

    terraform init -upgrade

Aplica los cambios

  1. Revisa la configuración y comprueba que los recursos que va a crear o actualizar Terraform se ajustan a tus expectativas:
    terraform plan

    Haga las correcciones necesarias en la configuración.

  2. Aplica la configuración de Terraform ejecutando el siguiente comando e introduciendo yes en la petición:
    terraform apply

    Espera hasta que Terraform muestre el mensaje "Apply complete!".

  3. Abre tu Google Cloud proyecto para ver los resultados. En la Google Cloud consola, ve a tus recursos en la interfaz de usuario para asegurarte de que Terraform los ha creado o actualizado.

Eliminar los cambios

Para eliminar los cambios, sigue estos pasos:

  1. Para inhabilitar la protección contra la eliminación, en el archivo de configuración de Terraform, asigna el valor false al argumento deletion_protection.
    deletion_protection =  "false"
  2. Aplica la configuración de Terraform actualizada ejecutando el siguiente comando e introduciendo yes en la petición:
    terraform apply
  1. Para quitar los recursos que se hayan aplicado anteriormente con tu configuración de Terraform, ejecuta el siguiente comando e introduce yes en la petición:

    terraform destroy

REST v1

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "SQLSERVER_2019_STANDARD",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-custom-2-7680",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

En las instancias en las que Private Service Connect está habilitado, se incluyen los siguientes campos:

  • allowedConsumerProjects: lista de los proyectos permitidos de la instancia. Puedes crear endpoints de Private Service Connect desde cualquier red de VPC de estos proyectos hasta la vinculación de servicio de la instancia.
  • pscEnabled: indica si una instancia tiene habilitado Private Service Connect.
  • pscServiceAttachmentLink: el URI que apunta al archivo adjunto de servicio de la instancia. Usa este URI para crear el endpoint de Private Service Connect.
  • dnsName: el nombre de DNS de la instancia. Te recomendamos que crees un registro DNS con este nombre y lo dirijas a la dirección IP del punto final de Private Service Connect. También te recomendamos que uses este nombre para conectarte a la instancia.

Para ver cómo crear la solicitud de API REST subyacente de esta tarea, consulta la página instances:get.

REST v1beta4

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "SQLSERVER_2019_STANDARD",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-custom-2-7680",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

En las instancias en las que Private Service Connect está habilitado, se incluyen los siguientes campos:

  • allowedConsumerProjects: lista de los proyectos permitidos de la instancia. Puedes crear endpoints de Private Service Connect desde cualquier red de VPC de estos proyectos hasta la vinculación de servicio de la instancia.
  • pscEnabled: indica si una instancia tiene habilitado Private Service Connect.
  • pscServiceAttachmentLink: el URI que apunta al archivo adjunto de servicio de la instancia. Usa este URI para crear el endpoint de Private Service Connect.
  • dnsName: el nombre de DNS de la instancia. Te recomendamos que crees un registro DNS con este nombre y lo dirijas a la dirección IP del punto final de Private Service Connect. También te recomendamos que uses este nombre para conectarte a la instancia.

Es posible que veas algunos banners en la parte superior que te sugieran acciones que puedes llevar a cabo.

Ver el endpoint de escritura

Un endpoint de escritura es un nombre de servicio de nombres de dominio (DNS) global que se resuelve automáticamente en la dirección IP de la instancia principal actual. Este endpoint redirige las conexiones entrantes a la nueva instancia principal automáticamente en caso de conmutación por error o conmutación de una réplica. Puede usar el endpoint de escritura en una cadena de conexión SQL en lugar de una dirección IP. Si usas un endpoint de escritura, no tendrás que hacer cambios en la conexión de la aplicación cuando se produzca una interrupción en una región.

Para obtener más información sobre cómo usar un endpoint de escritura para conectarte a una instancia, consulta Conectarse a una instancia mediante un endpoint de escritura.

Métricas

En esta sección se proporcionan gráficos de uso de métricas de instancias clave que puedes usar para monitorizar tus instancias. Cuando trabaje con datos de métricas, tenga en cuenta lo siguiente:

  • Un punto de datos de una métrica es un agregado de todas las bases de datos alojadas en la instancia.
  • Los datos se registran en la hora local.
  • Los gráficos renderizados no se actualizan automáticamente. Para ver los datos nuevos, debes actualizar la página.
  • Hay un retraso de unos minutos entre el momento en que se registran los datos de las métricas y el momento en que se muestran en los gráficos de uso.

Para obtener más información sobre las métricas que se muestran en el gráfico, consulta el artículo Monitorizar instancias de Cloud SQL.

Para ver una lista completa de las métricas de Cloud SQL que proporciona Cloud Monitoring, consulta la lista de métricas de Cloud SQL.

Para obtener más información sobre cómo usar Cloud Monitoring con Google Cloud, consulta la documentación de Cloud Monitoring.

Conectarse a esta instancia

En la sección Conectar a esta instancia, puedes encontrar las direcciones IP, la red de VPC y el nombre de conexión de tu instancia.

Para abrir una terminal y conectarte a tu instancia, haz clic en Conectarse mediante Cloud Shell.

Para abrir un tutorial relacionado en el panel de la derecha, haz clic en Conectarse desde una instancia de VM de Compute Engine.

Para ir a Opciones de conexión, haz clic en Ver todos los métodos de conexión.

Para obtener más información sobre cómo conectarse a una instancia, consulta la información general sobre la conexión.

Cuenta de servicio

En esta sección se muestra la dirección de correo de la cuenta de servicio de la instancia.

Para obtener más información, consulta la documentación sobre cuentas de servicio de gestión de identidades y accesos.

Configuración

En esta sección se muestran los ajustes de configuración actuales de la instancia.

Para cambiar los ajustes de configuración, haz clic en Editar configuración.

Para obtener más información sobre cómo editar la configuración de la instancia, consulta Editar una instancia.

Operaciones y registros

En esta sección se enumeran las operaciones recientes de la instancia, como la creación de copias de seguridad.

Para ver las operaciones recientes, haz clic en Ver todas las operaciones.

Para ver la información de registro, haz clic en Ver registros de errores de SQL Server.

Para obtener más información sobre las páginas Operaciones y Explorador de registros, consulta Registros de Cloud SQL.

Para obtener información genérica sobre el registro, consulta los artículos Ver registros y Exportar registros.

Mantenimiento

En esta sección se muestran los ajustes y la programación de las actualizaciones de mantenimiento.

Para cambiar las preferencias, haz clic en Editar preferencias de mantenimiento.

Para cambiar los ajustes de las notificaciones, haz clic en Editar preferencias de notificaciones.

Para obtener más información sobre el mantenimiento en Cloud SQL, consulta el resumen del mantenimiento.

Siguientes pasos