Ver información de una instancia

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

gcloud CLI o la API.

Console

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

    Ir a Instancias de Cloud SQL

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

  2. Para ver el estado actual de la instancia, mantén el puntero sobre el ícono de estado junto al nombre de una instancia.

    Si la instancia está en estado FAILED o MAINTENANCE, puedes recuperarla seleccionando una hora anterior y restableciendo la instancia a su estado en ese momento.

  3. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.

    En la tarjeta Conéctate a esta instancia, aparece la siguiente información adicional sobre las instancias de Cloud SQL con Private Service Connect habilitado:

    • Conectividad de IP privada: el estado es Habilitada porque la instancia debe tener una dirección IP interna
    • Proyectos permitidos: estos proyectos permiten conexiones desde extremos de Private Service Connect a la instancia
    • Adjunto de servicio: el adjunto de servicio de la instancia
    • Conectividad de IP pública: el estado es Inhabilitada porque no se admiten conexiones IP externas

  4. Para ver la información de conectividad sobre la instancia, lo que incluye si se agrega una dirección IP interna o externa a la instancia, cualquier red autorizada asociada con la instancia y si otros servicios de Google Cloud, como BigQuery, pueden acceder a los datos en Cloud SQL y realizar consultas en estos datos a través de una conexión interna, 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. Aparece la siguiente información sobre las instancias que tienen Private Service Connect habilitado:

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

gcloud

Para obtener información sobre cómo instalar y comenzar a usar la CLI de gcloud, consulta Instala la CLI de gcloud. Para obtener información sobre cómo iniciar Cloud Shell, consulta Usa Cloud Shell.

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

    gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID

    Realiza los siguientes reemplazos:

    Este es un ejemplo del resultado para 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 que tienen habilitado Private Service Connect, agrega los siguientes parámetros:
    3. Configuración 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 orientes a la dirección IP del extremo de Private Service Connect. También te recomendamos que uses este nombre para conectarte a la instancia.
    Adjunto de servicio pscServiceAttachmentLink El URI que apunta al adjunto de servicio de la instancia. Usa este URI para crear el extremo de Private Service Connect.
    Proyectos de consumidor permitidos allowedConsumerProjects Una lista de los proyectos permitidos para la instancia. Puedes crear extremos de Private Service Connect desde cualquier red de VPC en estos proyectos al adjunto de servicio de la instancia.
    Habilita Private Service Connect pscEnabled Indica si una instancia tiene Private Service Connect habilitado.

Terraform

Para crear una instancia, usa un recurso de Terraform.

resource "google_sql_database_instance" "postgres_pvp_instance_name" {
  name             = "postgres-pvp-instance-name"
  region           = "asia-northeast1"
  database_version = "POSTGRES_14"
  root_password    = "abcABC123!"
  settings {
    tier = "db-custom-2-7680"
    password_validation_policy {
      min_length                  = 6
      reuse_interval              = 2
      complexity                  = "COMPLEXITY_DEFAULT"
      disallow_username_substring = true
      password_change_interval    = "30s"
      enable_password_policy      = true
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Aplique los cambios

Para aplicar tu configuración de Terraform en un proyecto de Google Cloud, completa los pasos de las siguientes secciones.

Prepara Cloud Shell

  1. Inicia Cloud Shell

  2. Establece el proyecto de Google Cloud predeterminado en el que deseas aplicar tus configuraciones de Terraform.

    Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

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

Prepara 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 dentro de ese directorio. El nombre del archivo debe tener la extensión .tf, por ejemplo, main.tf. En este instructivo, el archivo se denomina main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Si sigues un instructivo, puedes copiar el código de muestra en cada sección o paso.

    Copia el código de muestra en el main.tf recién creado.

    De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.

  3. Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
  4. Guarda los cambios.
  5. Inicializa Terraform. Solo debes hacerlo una vez por directorio. 
    terraform init

    De manera opcional, incluye la opción -upgrade para usar la última versión del proveedor de Google: 

    terraform init -upgrade

Aplica los cambios

  1. Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas: 
    terraform plan

    Corrige la configuración según sea necesario.

  2. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe yes cuando se te solicite: 
    terraform apply

    Espera hasta que Terraform muestre el mensaje “¡Aplicación completa!”.

  3. Abre tu proyecto de Google Cloud para ver los resultados. En la consola de Google Cloud, navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

Borra los cambios

Para borrar tus cambios, haz lo siguiente:

  1. Para inhabilitar la protección contra la eliminación, en tu archivo de configuración de Terraform, establece el argumento deletion_protection en false. 
    deletion_protection =  "false"
  2. Para aplicar la configuración actualizada de Terraform, ejecuta el siguiente comando y, luego, ingresa yes cuando se te solicite: 
    terraform apply

  1. Quita los recursos que se aplicaron antes con tu configuración de Terraform a través de la ejecución del siguiente comando y, luego, ingresa yes cuando se te solicite:

    terraform destroy

REST v1

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

HTTP method and URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
  "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"
}

Existen los siguientes campos para las instancias que tienen Private Service Connect habilitado:

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

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

REST v1beta4

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

HTTP method and URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
  "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"
}

Existen los siguientes campos para las instancias que tienen Private Service Connect habilitado:

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

Es posible que veas algunos banner en la parte superior que sugieren acciones que puedes realizar.

Cómo ver el extremo de escritura

Un extremo de escritura es un nombre de servicio de nombre de dominio (DNS) global que se resuelve automáticamente en la dirección IP de la instancia principal actual. Este extremo redirecciona automáticamente las conexiones entrantes a la nueva instancia principal en caso de una operación de conmutación por error o cambio de réplica. Puedes usar el extremo de escritura en una cadena de conexión de SQL en lugar de una dirección IP. Cuando usas un extremo de escritura, puedes evitar tener que realizar cambios en la conexión de la aplicación cuando se produce una interrupción regional.

Cloud SQL genera automáticamente un extremo de escritura para tu instancia de la edición de Cloud SQL Enterprise Plus si haces lo siguiente:

  1. Habilita la API de Cloud DNS para tu proyecto de Google Cloud.

  2. Crea la instancia

  3. Selecciona Enterprise Plus como la edición de Cloud SQL para tu instancia.
  4. Agrega una dirección IP privada a la instancia.
  5. Especifica una red asociada para la instancia.
  6. De manera opcional, especifica un rango de IP asignado para la instancia.

Si ya tienes una instancia de la edición de Cloud SQL Enterprise Plus y deseas que Cloud SQL genere un extremo de escritura automáticamente, crea una réplica que esté habilitada para la recuperación ante desastres avanzada.

Para obtener más información sobre cómo recuperar el extremo de escritura y usarlo para conectarte a la instancia, consulta Cómo conectarse con un extremo de escritura.

Métricas

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

  • Un punto de datos para una métrica es un agregado de todas las bases de datos que aloja una instancia.
  • Los datos se informan en la hora local.
  • Los gráficos procesados no se actualizan de forma automática. Para ver los datos nuevos, debes actualizar la página.
  • Hay unos minutos de retraso entre el momento en que se registra un dato de métrica y el momento en que se muestra en los gráficos de uso.

Para obtener más información sobre las métricas que se muestran en el gráfico, consulta la página Supervisa instancias de Cloud SQL.

Para obtener 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 el uso de Cloud Monitoring con Google Cloud, consulta la documentación de Cloud Monitoring.

Conectarse a esta instancia

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

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

Para abrir un instructivo relacionado en el panel derecho, 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 conectarte a una instancia, consulta la Descripción general de la conexión.

Cuenta de servicio

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

Para obtener más información, consulta la documentación de las cuentas de servicio de IAM.

Configuración

En esta sección, se muestra la configuración actual de la instancia.

Para cambiar la 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 cómo editar una instancia.

Operaciones y registros

En esta sección, se enumeran las operaciones de instancias recientes, 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 error de PostgreSQL.

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

Para obtener información genérica sobre el registro, consulta Visualiza los registros y Exporta registros.

Mantenimiento

En esta sección, se muestran la configuración y el programa de la actualización del mantenimiento actual.

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

Para cambiar la configuración de las notificaciones, haz clic en Editar preferencias de notificaciones.

Para obtener más información sobre el mantenimiento en Cloud SQL, consulta Descripción general de mantenimiento.

Próximos pasos