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

Importante: 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:

Habilita la API de Cloud DNS para tu proyecto de Google Cloud.
Crea la instancia
Selecciona Enterprise Plus como la edición de Cloud SQL para tu instancia.
Agrega una dirección IP privada a la instancia.
Especifica una red asociada para la instancia.
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.

El extremo de escritura es un nombre de servicio de nombre de dominio (DNS) que se resuelve en la dirección IP de la instancia principal. Este extremo redirecciona automáticamente las conexiones entrantes a la 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.

Para obtener más información acerca del uso del extremo de escritura para conectarte a la instancia, consulta Conéctate con un extremo de escritura. Para obtener el extremo de escritura, usa gcloud CLI o la API.

Console

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:
- Método de conexión interna: indica si se usa Private Service Connect o el acceso privado a servicios para conectarse a la instancia.
- Dirección IP privada: son las direcciones IP de los extremos de Private Service Connect en la red de VPC que se conectan al adjunto de servicio de la instancia.
- Nombre de DNS: el nombre de DNS de la instancia
Para ver el estado actual de la instancia, mantén el puntero sobre el ícono de estado junto al nombre de una instancia.
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
Para ver la información de 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.
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.

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:
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL. Si esta instancia tiene Private Service Connect habilitado para ella, los extremos de Private Service Connect en las redes de VPC pueden conectarse a ella.
- PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia.
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
```

Para ver información más detallada sobre las instancias que tienen habilitado Private Service Connect, agrega los siguientes parámetros:

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.

Aplica 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

Inicia Cloud Shell
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).

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
```
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.
Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
Guarda los cambios.
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

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.
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!”.
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:

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"
```
Para aplicar la configuración actualizada de Terraform, ejecuta el siguiente comando y, luego, ingresa yes cuando se te solicite:
```
terraform apply
```

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:

PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia.
INSTANCE_NAME: el nombre de la instancia de Cloud SQL. Si esta instancia tiene Private Service Connect habilitado para ella, los extremos de Private Service Connect en las redes de VPC pueden conectarse a ella.

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:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "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"
}

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:

PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia.
INSTANCE_NAME: el nombre de la instancia de Cloud SQL. Si esta instancia tiene Private Service Connect habilitado para ella, los extremos de Private Service Connect en las redes de VPC pueden conectarse a ella.

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:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "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"
}

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.

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

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

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

Obtén más información sobre las métricas de Cloud Monitoring para Cloud SQL.
Obtén más información sobre la configuración de instancias.
Obtén más información sobre cómo editar una instancia.