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
En la Google Cloud consola, ve a la página Instancias de Cloud SQL.
Se muestra la siguiente información sobre las instancias de Cloud SQL que tienen habilitado Private Service Connect:
- Método de conexión interna: si se usa Private Service Connect o acceso a servicios privados para conectarse a la instancia
- Dirección IP privada: las direcciones IP de los puntos finales de Private Service Connect de la red de VPC que se conectan a la vinculación de servicio de la instancia.
- Nombre de DNS: el nombre de DNS de la instancia.
- Para ver el estado actual de una instancia, coloca el puntero sobre el icono de estado situado junto al nombre de la instancia.
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.
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.
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.
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:
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL. Si esta instancia tiene habilitado Private Service Connect, los puntos finales de Private Service Connect de las redes de VPC pueden conectarse a ella.
- PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia.
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
- Para ver información más detallada sobre las instancias en las que Private Service Connect está habilitado, añada los siguientes parámetros:
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
- Abre Cloud Shell.
-
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).
-
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 comomain.tf
.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
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.
- Revisa y modifica los parámetros de ejemplo para aplicarlos a tu entorno.
- Guarda los cambios.
-
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
-
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.
-
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!".
- 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:
- Para inhabilitar la protección contra la eliminación, en el archivo de configuración de Terraform, asigna el valor
false
al argumentodeletion_protection
.deletion_protection = "false"
- Aplica la configuración de Terraform actualizada ejecutando el siguiente comando e introduciendo
yes
en la petición:terraform apply
-
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:
- PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL. Si esta instancia tiene habilitado Private Service Connect, los puntos finales de Private Service Connect de las redes de VPC pueden conectarse a ella.
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:
- PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL. Si esta instancia tiene habilitado Private Service Connect, los puntos finales de Private Service Connect de las redes de VPC pueden conectarse a ella.
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
- Consulta más información sobre las métricas de Cloud Monitoring para Cloud SQL.
- Lee más detalles sobre la configuración de instancias.
- Más información sobre cómo editar una instancia