En esta página, se describe cómo ejecutar sentencias de SQL en bases de datos de instancias de Cloud SQL con la API de Data. Con la API de datos, usas la API de Cloud SQL Admin y la gcloud CLI para ejecutar sentencias de SQL en cualquier instancia en la que hayas habilitado el acceso a la API de datos.
Puedes usar la API de datos con instancias que usen direcciones IP públicas, acceso privado a servicios o Private Service Connect. La API de datos admite todos los tipos de sentencias de SQL, incluidos el lenguaje de manipulación de datos (DML), el lenguaje de definición de datos (DDL) y el lenguaje de consulta de datos (DQL). La API de datos es buena para ejecutar sentencias administrativas pequeñas y rápidas, como crear roles o usuarios de bases de datos y realizar pequeñas actualizaciones de esquemas. También puedes usar la API de datos para habilitar las extensiones de PostgreSQL.
Antes de comenzar
Antes de ejecutar sentencias de SQL en una instancia, sigue estos pasos.
Configura el usuario de la base de datos
La API de datos debe autenticarse como un usuario de la base de datos para ejecutar sentencias de SQL. Puedes autenticarte como un usuario integrado, un usuario de IAM, una cuenta de servicio de IAM o un grupo de IAM.
Para autenticarte con IAM, haz lo siguiente:
- Configura la instancia para la autenticación de la base de datos de IAM.
- Agrega un usuario, una cuenta de servicio o un grupo de IAM a la instancia.
- Otorga a la cuenta los roles o privilegios necesarios para ejecutar sentencias de SQL. Puedes asignar roles de base de datos mientras creas
la cuenta o actualizas
la cuenta. Si creaste roles de base de datos personalizados con los
privilegios mínimos,
asígnalos a la cuenta. De lo contrario, asigna el rol predefinido
cloudsqlsuperusera la cuenta, usa la API de datos para crear nuevos roles de base de datos personalizados con menos privilegios y, luego, otorga los roles nuevos a la cuenta en lugar decloudsqlsuperuser.
Para autenticarte como un usuario integrado con una contraseña, haz lo siguiente:
- Crea una
cuenta de usuario con una contraseña no vacía.
También puedes usar el usuario predeterminado
postgres. - Otorga a la cuenta los roles o privilegios necesarios para ejecutar sentencias de SQL. Puedes asignar roles de base de datos mientras creas
la cuenta o actualizas
la cuenta. Si creaste roles de base de datos personalizados con los
privilegios mínimos,
asígnalos a la cuenta. De lo contrario, asigna el rol predefinido
cloudsqlsuperusera la cuenta, usa la API de datos para crear nuevos roles de base de datos personalizados con menos privilegios y, luego, otorga los roles nuevos a la cuenta en lugar decloudsqlsuperuser. - Usa Secret Manager para crear un secreto regional y almacenar la contraseña. Por motivos de seguridad, la API de datos solicita el nombre del recurso del secreto en lugar de la contraseña en la solicitud a la API. El secreto regional debe almacenarse en la misma región que tu instancia de Cloud SQL. No se admite un secreto creado con el extremo global de Secret Manager, incluso si se almacena en la misma región.
- Otorga
roles/secretmanager.secretAccessoral emisor de la API de datos. Como práctica recomendada, define condiciones de IAM para permitir que un usuario acceda a un secreto específico, pero no a otros secretos del proyecto.
Roles o permisos obligatorios
Las cuentas de usuario o de servicio que se usan para llamar a la API de datos deben tener el permiso
para ejecutar sentencias de SQL, cloudsql.instances.executesql. El permiso se
incluye en uno de los siguientes roles predefinidos:
Cloud SQL Admin(roles/cloudsql.admin)Cloud SQL Instance User(roles/cloudsql.instanceUser)Cloud SQL Studio User(roles/cloudsql.studioUser)
También puedes definir un rol personalizado de IAM para la cuenta de servicio o usuario que incluya el permiso cloudsql.instances.executesql. Este permiso es compatible con los roles personalizados de IAM.
Cuando se usa un secreto de Secret Manager para autenticar, el usuario o la cuenta de servicio
también deben tener el permiso para acceder al secreto,
secretmanager.versions.access. El permiso se incluye en uno de los
siguientes roles predefinidos:
Secret Manager Secret Accessor(roles/secretmanager.secretAccessor)Secret Manager Admin(roles/secretmanager.admin)
Habilita o inhabilita la API de datos
Para usar la API de datos, debes habilitarla en cada instancia. Puedes inhabilitar la API de datos en cualquier momento.
Console
-
En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.
- Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
- En el menú de navegación de SQL, selecciona Conexiones.
- Haz clic en la pestaña Redes.
- Selecciona la casilla de verificación Permitir la API de datos.
- Haz clic en Guardar.
gcloud
Para habilitar el acceso a la API de datos en una instancia, usa el comando gcloud sql instances patch con la marca --data-api-access=ALLOW_DATA_API:
gcloud sql instances patch INSTANCE_NAME --data-api-access=ALLOW_DATA_API
Para inhabilitar el acceso a la API de datos, usa la marca --data-api-access=DISALLOW_DATA_API:
gcloud sql instances patch INSTANCE_NAME --data-api-access=DISALLOW_DATA_API
Reemplaza INSTANCE_NAME por el nombre de la instancia en la que deseas habilitar o inhabilitar la API de datos.
REST
Para habilitar el acceso a la API de datos en una instancia, envía una solicitud PATCH al extremo instances.patch:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
El cuerpo de la solicitud debe contener el campo dataApiAccess configurado como ALLOW_DATA_API:
{ "dataApiAccess": "ALLOW_DATA_API" }
Para inhabilitar el acceso a la API de datos, establece dataApiAccess en DISALLOW_DATA_API.
Ejecuta una instrucción de SQL
Puedes ejecutar sentencias de SQL en las bases de datos de tu instancia de Cloud SQL con gcloud CLI o la API de REST.
Autentica con IAM
Puedes ejecutar sentencias de SQL con la autenticación de base de datos de IAM.
gcloud
Para ejecutar una instrucción de SQL en una base de datos de una instancia con la gcloud CLI, usa el comando gcloud sql instances execute-sql.
gcloud sql instances execute-sql INSTANCE_NAME \ --database=DATABASE_NAME \ --sql=SQL_STATEMENT \ --partial-result-mode=PARTIAL_RESULT_MODE
Realiza los siguientes reemplazos:
- INSTANCE_NAME: El nombre de la instancia.
- DATABASE_NAME: Es el nombre de la base de datos dentro de la instancia.
- SQL_STATEMENT: Es la instrucción de SQL que se ejecutará. Si la sentencia contiene espacios o caracteres especiales de shell, debe estar entre comillas.
- PARTIAL_RESULT_MODE: es opcional. Controla cómo responder cuando el resultado está incompleto. Puede ser
ALLOW_PARTIAL_RESULT,FAIL_PARTIAL_RESULToPARTIAL_RESULT_MODE_UNSPECIFIED. Consulta Modifica el comportamiento de truncamiento.
También puedes incluir la marca --project=PROJECT_ID si es necesario.
Terraform
Puedes usar la API de datos en Terraform para aprovisionar recursos en la base de datos, como bases de datos, tablas, extensiones, usuarios y otorgamientos de privilegios, sin conectarte
manualmente a la instancia. Para ejecutar una secuencia de comandos de SQL en Terraform, usa el
recurso de Terraform
google_sql_provision_script.
resource "google_sql_database_instance" "instance" { name = "my-instance" database_version = "POSTGRES_17" settings { tier = "db-perf-optimized-N-2" data_api_access = "ALLOW_DATA_API" # This allows the use of Data API. database_flags { name = "cloudsql.iam_authentication" value = "on" } } } /* * Create a database user for your account and grant roles so it has privilege to * access the database. Set the type toCLOUD_IAM_USERfor huamn account or *CLOUD_IAM_SERVICE_ACCOUNTfor service account. If a service account is used * and the instance is Postgres, trim the ".gserviceaccount.com" * suffix to avoid exceeding the username length limit. */ resource "google_sql_user" "iam_user" { name = "account-used-to-apply-this-config@example.com" instance = google_sql_database_instance.instance.name type = "CLOUD_IAM_USER" # Roles granted to the user. For least privilege, you can create smaller roles # and then assign them to this user in place of `cloudsqlsuperuser`. database_roles = ["cloudsqlsuperuser"] } resource "google_sql_database" "database" { name = "my-database" instance = google_sql_database_instance.instance.name } resource "google_sql_provision_script" "script" { # You can inline the script or import from a file likescript = file("${path.module}/script.sql")# When modified, the whole script will be executed again. It's recommended to # make the script idempotent with patterns likecreate if not exists ...or #if not exists (select ...) then ... end if. script = "CREATE TABLE IF NOT EXISTS table1 ( col VARCHAR(16) NOT NULL );" instance = google_sql_database_instance.instance.name database = google_sql_database.database.name description = "sql script to create tables" # The identity account used to apply your Terraform config must exist as an # IAM user or IAM service account in the instance. Terraform connects to the # instance via IAM database authentication to execute the script. depends_on = [google_sql_user.iam_user] }
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
- 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 denominamain.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.tfrecié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
-upgradepara 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
yescuando 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
Borrar un recurso google_sql_provision_script no borrará los
recursos de la base de datos que creó. Para borrarlas, puedes agregar declaraciones de forma explícita en
la secuencia de comandos, como drop ... if exists, y, luego, aplicar los cambios.
REST
Para ejecutar una instrucción de SQL en una base de datos de una instancia con la API de REST, envía una solicitud POST al extremo executeSql:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/executeSql
El cuerpo de la solicitud debe contener el nombre de la base de datos y la instrucción de SQL:
{ "database": "DATABASE_NAME", "sqlStatement": "SQL_STATEMENT", "partialResultMode": "PARTIAL_RESULT_MODE" "autoIamAuthn": true }
Realiza los siguientes reemplazos:
- PROJECT_ID: Es el ID del proyecto.
- INSTANCE_NAME: El nombre de la instancia.
- DATABASE_NAME: Es el nombre de la base de datos dentro de la instancia.
- SQL_STATEMENT: Es la instrucción de SQL que se ejecutará.
- PARTIAL_RESULT_MODE: es opcional. Controla cómo responde la API
cuando el resultado supera los 10 MB. Puede ser
FAIL_PARTIAL_RESULT,ALLOW_PARTIAL_RESULToPARTIAL_RESULT_MODE_UNSPECIFIED. Consulta Modifica el comportamiento de truncamiento.
Autenticación con contraseña
Puedes ejecutar sentencias de SQL con la autenticación de contraseña integrada cuando la contraseña se almacena como un secreto regional con Secret Manager en la misma región que la instancia de Cloud SQL.
gcloud
Para ejecutar una instrucción de SQL en una base de datos de una instancia con la gcloud CLI, usa el comando gcloud sql instances execute-sql.
gcloud sql instances execute-sql INSTANCE_NAME \ --database=DATABASE_NAME \ --sql=SQL_STATEMENT \ --user=USER \ --password-secret-version=PASSWORD_SECRET_VERSION \ --partial-result-mode=PARTIAL_RESULT_MODE
Realiza los siguientes reemplazos:
- INSTANCE_NAME: El nombre de la instancia.
- DATABASE_NAME: Es el nombre de la base de datos dentro de la instancia.
- SQL_STATEMENT: Es la instrucción de SQL que se ejecutará. Si la sentencia contiene espacios o caracteres especiales de shell, debe estar entre comillas.
- USER: Es el usuario de la base de datos con el que se autenticará.
- PASSWORD_SECRET_VERSION: Es el nombre del recurso del
secreto de Secret Manager que contiene la contraseña del usuario de la base de datos.
El secreto debe ser un
secreto regional y almacenarse en la misma región que la instancia de
Cloud SQL. El formato esperado del nombre del recurso es
projects/{project}/locations/{location}/secrets/{secret}/versions/{secret_version}. - PARTIAL_RESULT_MODE: es opcional. Controla cómo responder cuando el resultado está incompleto. Puede ser
ALLOW_PARTIAL_RESULT,FAIL_PARTIAL_RESULToPARTIAL_RESULT_MODE_UNSPECIFIED. Consulta Modifica el comportamiento de truncamiento.
Terraform
Puedes usar la API de datos en Terraform para aprovisionar recursos en la base de datos, como bases de datos, tablas, extensiones, usuarios y otorgamientos de privilegios, sin conectarte
manualmente a la instancia. Para ejecutar una secuencia de comandos de SQL en Terraform, usa el
recurso de Terraform
google_sql_provision_script.
resource "google_sql_user" "built_in_user" { name = "tf-user" host = "%" # Don't set this field for PostgreSQL and SQL Server. instance = google_sql_database_instance.instance.name password = "changeme" type = "BUILT_IN" } # Create a regional secret. Global secrets are not supported even if # located in one region only. resource "google_secret_manager_regional_secret" "secret" { secret_id = "db-password" # Use the same region as the Cloud SQL instance. location = "us-central1" } resource "google_secret_manager_regional_secret_version" "secret_version" { secret = google_secret_manager_regional_secret.secret.id secret_data = "changeme" } resource "google_sql_provision_script" "script" { # You can inline the script or import from a file likescript = file("${path.module}/script.sql")# When modified, the whole script will be executed again. It's recommended to # make the script idempotent with patterns likecreate if not exists ...or #if not exists (select ...) then ... end if. script = "CREATE TABLE IF NOT EXISTS table1 ( col VARCHAR(16) NOT NULL );" instance = google_sql_database_instance.instance.name database = google_sql_database.database.name description = "sql script to create tables" user = google_sql_user.built_in_user.name # The location should be the same as the Cloud SQL instance's location. password_secret_version = "projects/my-project/locations/us-central1/secrets/db-password/versions/latest" # The built-in database user and password secret version must be created # first. Cloud SQL will retrieve password from Secret Manager # and connect to this user account to execute your script. depends_on = [ google_sql_user.built_in_user, google_secret_manager_regional_secret_version.secret_version ] }
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
- 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 denominamain.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.tfrecié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
-upgradepara 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
yescuando 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
Borrar un recurso google_sql_provision_script no borrará los
recursos de la base de datos que creó. Para borrarlas, puedes agregar declaraciones de forma explícita en
la secuencia de comandos, como drop ... if exists, y, luego, aplicar los cambios.
REST
Para ejecutar una instrucción de SQL en una base de datos de una instancia con la API de REST, envía una solicitud POST al extremo executeSql:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME/executeSql
El cuerpo de la solicitud debe contener el nombre de la base de datos y la instrucción de SQL:
{ "database": "DATABASE_NAME", "sqlStatement": "SQL_STATEMENT", "user": "USER", "passwordSecretVersion": "PASSWORD_SECRET_VERSION", "partialResultMode": "PARTIAL_RESULT_MODE" }
Realiza los siguientes reemplazos:
- PROJECT_ID: Es el ID del proyecto.
- INSTANCE_NAME: El nombre de la instancia.
- DATABASE_NAME: Es el nombre de la base de datos dentro de la instancia.
- SQL_STATEMENT: Es la instrucción de SQL que se ejecutará.
- USER: Es el usuario de la base de datos con el que se autenticará.
- PASSWORD_SECRET_VERSION: Es el nombre del recurso del
secreto de Secret Manager que contiene la contraseña del usuario de la base de datos.
El secreto debe ser un
secreto regional y almacenarse en la misma región que la instancia de
Cloud SQL. El formato esperado del nombre del recurso es
projects/{project}/locations/{location}/secrets/{secret}/versions/{secret_version}. - PARTIAL_RESULT_MODE: es opcional. Controla cómo responde la API
cuando el resultado supera los 10 MB. Puede ser
FAIL_PARTIAL_RESULT,ALLOW_PARTIAL_RESULToPARTIAL_RESULT_MODE_UNSPECIFIED. Consulta Modifica el comportamiento de truncamiento.
Modifica el comportamiento de truncamiento
Puedes controlar cómo se manejan los resultados grandes cuando ejecutas SQL. Para ello, incluye
el campo "partialResultMode" en la solicitud. Este campo acepta los siguientes
valores:
FAIL_PARTIAL_RESULT: Predeterminado. Genera un error si el resultado supera los 10 MB o si solo se puede recuperar un resultado parcial. No devuelvas el resultado.ALLOW_PARTIAL_RESULT: Muestra un resultado truncado y establecepartial_resulten verdadero si el resultado supera los 10 MB o si solo se puede recuperar un resultado parcial debido a un error. No arrojes un error.PARTIAL_RESULT_MODE_UNSPECIFIED: Es el modo sin especificar, que es igual aFAIL_PARTIAL_RESULT.
Consultas de auditoría
Puedes hacer un seguimiento del nombre de la aplicación configurando el campo applicationName en la
solicitud. La base de datos hará un seguimiento del nombre de la aplicación en las estadísticas de la sesión, por
ejemplo, en la tabla
pg_stat_activity.
Puedes usar las Estadísticas de consultas para
hacer un seguimiento de más información sobre tus consultas y analizar los problemas de rendimiento.
Ten en cuenta que Estadísticas de consultas mostrará que la IP del cliente de las consultas de ExecuteSql es localhost,
ya que la conexión de la base de datos se realiza desde la instancia de Cloud SQL.
También puedes usar pg-audit para registrar consultas con fines de seguridad o cumplimiento.
Limitaciones
- El límite de tamaño de una respuesta es de 10 MB. Los resultados que superen este tamaño se truncarán si
partialResultModese establece enALLOW_PARTIAL_RESULT; de lo contrario, se arrojará un error. - Las solicitudes tienen un límite de 0.5 MB.
- Solo puedes ejecutar sentencias de SQL para las instancias de Cloud SQL para PostgreSQL que se estén ejecutando.
- Cloud SQL no admite el uso de la API de datos con instancias configuradas para la replicación de servidores externos.
- Las solicitudes que tarden más de 30 segundos se cancelan. No se admite establecer un tiempo de espera de sentencia más alto con
SET STATEMENT_TIMEOUT. Cloud SQL limita la cantidad de solicitudes
executeSqlsimultáneas por instancia para evitar la sobrecarga. Si se alcanza el límite, las solicitudes posteriores fallan y devuelven uno de los siguientes errores:At most 'x' concurrent queries may be run on this instance. Try again later.Maximum concurrent reads 'x' reached.
El límite (
x) es de 10 consultas por instancia.Cada respuesta puede contener un máximo de 10 mensajes o advertencias de la base de datos.
Si hay un error de sintaxis o de ejecución de la sentencia, no se devuelve ningún resultado.
La API de datos no puede autenticarse como usuarios integrados con contraseñas vacías.
Las sentencias que consumen una gran cantidad de memoria pueden causar errores de memoria insuficiente. Para obtener más información sobre cómo evitar estos errores, consulta Prácticas recomendadas para administrar el uso de memoria. Una instancia de base de datos que se ejecuta con un uso de memoria alto suele causar problemas de rendimiento, atascos o, incluso, tiempo de inactividad de la base de datos.
La API de datos se puede bloquear de forma temporal con fines de integridad de los datos cuando se realizan ciertas operaciones de mantenimiento en la instancia. Si esto sucede, vuelve a intentarlo más tarde.
- Si ejecutas varias instrucciones en el editor de consultas al mismo tiempo y una o más instrucciones generan un error, se anulará la ejecución de todas las instrucciones y se mostrará el primer error encontrado.
- Cuando el servidor de la base de datos detecta una sintaxis de consulta no válida, genera un
registro en
postgres.log. Estas entradas aparecen como entradascloudsqladminy contienen la consulta no válida, la posición del error de sintaxis y un mensaje de error correspondiente. Para quitar estos registros de tu vista, configura filtros de registro para excluir la base de datoscloudsqladmin, el usuariocloudsqladmino ambos.
- La secuencia de comandos de SQL y su respuesta de ejecución pueden transitar por ubicaciones intermedias
entre tu cliente y la ubicación de la instancia de destino. Por
este motivo, las solicitudes fallarán con el error "no se admite para instancias
en ciertas carpetas de paquetes de control de Assured Workloads" en ciertos proyectos de Assured Workloads y en proyectos con
constraints/sql.restrictNoncompliantResourceCreationaplicado de forma manual.
Solucionar problemas
En esta sección, se incluye información sobre los problemas asociados con el uso de la API de datos, junto con los pasos para solucionarlos.
| Problema | Soluciona problemas |
|---|---|
The instance doesn't allow using ExecuteSql to access this instance.
You can allow it by patching the instance with {settings: { dataApiAccess:
"ALLOW_DATA_API" }}
|
La API de datos está inhabilitada de forma predeterminada. Habilita la API de datos en la instancia para resolver el problema. |
Secret cannot be provided when auto_iam_authn is true.
|
Cuando configuras auto_iam_authn como true, te autenticas en la base de datos con IAM.
Este método de autenticación no requiere una contraseña ni un secreto.
Consulta
Autentica con IAM.
|
ExecuteSql API is not supported for instances in certain
Assured Workloads control packages folders yet.
|
La secuencia de comandos de SQL y su respuesta de ejecución pueden transitar por ubicaciones intermedias
entre tu cliente y la ubicación de la instancia de destino. Por
este motivo, las solicitudes fallarán para las instancias en ciertos proyectos de
Assured Workloads. Si tu proyecto no está inscrito en Assured Workloads, pero
constraints/sql.restrictNoncompliantResourceCreation se aplica de forma manual,
pídele al administrador de tu organización que
quite la restricción y el problema se resolverá en las instancias
recién creadas.
|
IAM authentication is not enabled for the instance
|
Configura la instancia para la autenticación de IAM para resolver el problema. |
The database is currently unavailable.
|
Es posible que la instancia se esté reiniciando, esté en mantenimiento o se encuentre en un estado incorrecto. Verifica el estado de la instancia y vuelve a intentarlo más tarde. |