En esta página, se describe cómo explorar y administrar tus datos de Cloud SQL con Cloud SQL Studio en la consola de Google Cloud.
Cloud SQL Studio permite que los usuarios autorizados interactúen directamente con la base de datos de SQL y ejecuten consultas de SQL desde la consola de Google Cloud para acceder y manipular datos. Puedes realizar un rango de acciones que realizarías en un cliente de línea de comandos de SQL, como crear índices y tablas, modificar tablas o configurar vistas.
Cloud SQL Studio incluye un panel llamado Explorador que está integrado con un editor de consultas y una tabla de resultados de consultas en SQL. Puedes ejecutar declaraciones DDL, DML y DQL desde esta misma interfaz. Por ejemplo, en lugar de configurar una herramienta de consultas de una base de datos de terceros, puedes crear una tabla y consultar tus datos con el editor de consultas en Cloud SQL Studio.
Puedes usar el panel Explorador para visualizar los objetos de tu base de datos, así como para interactuar con ellos. Puedes crear, modificar y borrar los objetos de la base de datos, como los siguientes:
- Tablas
- Columnas
- Índices y claves
- Funciones
También puedes usar el panel Explorador para generar consultas SELECT
para tablas.
Si es la primera vez que usas Cloud SQL, consulta la Descripción general de Cloud SQL.
Roles y permisos requeridos
Para obtener los permisos que necesitas para completar las tareas de este documento,
pídele a tu administrador que te otorgue el
rol de IAM de usuario de Cloud SQL Studio (roles/cloudsql.studioUser
) en el proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Para usar Cloud SQL Studio, debes tener los siguientes permisos:
cloudsql.databases.list
cloudsql.instances.executeSql
cloudsql.instances.get
cloudsql.users.list
Además, asegúrate de tener permisos a nivel de base de datos para la base de datos que usas en la autenticación y la contraseña del usuario de base de datos privilegiado que usarás. La autenticación de IAM no es compatible con Cloud SQL Studio.
Explora tus datos
Para acceder al panel Explorador, sigue estos pasos:
-
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
- Elige una instancia de la lista.
- En el menú de navegación, haz clic en Cloud SQL Studio.
- Accede a Cloud SQL con el nombre de tu base de datos, así como tu nombre de usuario y contraseña. En el panel Explorador muestra una lista de los objetos de tu base de datos.
Crea, modifica y consulta tus datos
Con el editor de SQL, puedes ejecutar cualquier combinación de declaraciones DDL, DML y DQL. Puedes redactar una consulta tú mismo o puedes propagar el editor de consultas con una plantilla mediante el explorador.
Para estructurar, modificar o consultar tus datos, sigue estos pasos:
-
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
- Elige una instancia de la lista.
- En el menú de navegación, haz clic en Cloud SQL Studio.
- Accede a Cloud SQL con el nombre de tu base de datos, nombre de usuario y contraseña.
- Redacta una consulta con uno de los siguientes métodos:
- Para redactar tu propia consulta, sigue estos pasos:
- Abre una pestaña nueva con solo hacer clic en
- Escribe tu consulta cuando aparezca el editor de consultas.
- Para redactar una consulta que comience con una plantilla, sigue estos pasos:
- En el panel Explorador, junto a un objeto o una colección de bases de datos, haz clic en more_vert Ver acciones. Aparecerán una o más acciones disponibles.
- Haz clic en una acción. El editor de consultas se propaga con una plantilla.
- Reemplaza cualquier marcador de posición en la plantilla.
- Para redactar tu propia consulta, sigue estos pasos:
- Ejecuta tus consultas con cualquiera de los siguientes enfoques:
- Para ejecutar todas las instrucciones en el Editor de consultas, haz clic en Ejecutar.
- Para ejecutar sentencias específicas, selecciona una o varias y haz clic en Ejecutar seleccionadas.
- Los resultados de tus consultas aparecen en la pestaña Resultados. Si hay varios conjuntos de resultados disponibles, selecciona un resultado de la lista desplegable Todos los resultados.
Limitaciones
- Cloud SQL Studio admite consultas ligeras. Las respuestas de más de 10 MB podrían truncarse. Cloud SQL Studio indica el momento en que se devuelven resultados parciales.
- Solo puedes ejecutar consultas para las instancias de Cloud SQL que se estén ejecutando.
- Cloud SQL Studio no es compatible con servidores externos.
- Las solicitudes que tarden más de cinco minutos se cancelan. En el caso de Cloud SQL para MySQL 5.6 y 5.7, el tiempo de espera de las declaraciones DDL de larga duración puede causar archivos o tablas huérfanos que no se pueden revertir de forma segura. Ten cuidado con las consultas como
ALTER TABLE
en tablas grandes. - Cloud SQL Studio no mantiene abierta una conexión de base de datos después de que se completa la ejecución de una secuencia de comandos SQL. Del mismo modo, las pestañas del editor no comparten una sesión común y cada ejecución inicia una sesión nueva.
- Cuando ejecutas una combinación de declaraciones DML, DQL y DDL, solo se mostrarán los resultados de las consultas de DQL.
- Cerrar el navegador o la pestaña del navegador no detiene la ejecución de la consulta en Cloud SQL Studio. La consulta se ejecutará hasta que se complete o se agote el tiempo de espera.
- Cloud SQL Studio no admite la ejecución de consultas de
SELECT
en datos deBLOB
. Si la secuencia de comandos SQL produce una columnaBLOB
en el resultado, la secuencia de comandos SQL falla con un error. - Los comandos del cliente de Cloud SQL para MySQL no son compatibles y no se pueden ejecutar en Cloud SQL Studio.
- El usuario
root
no es compatible con Cloud SQL Studio. - Cloud SQL Studio siempre requiere una base de datos, incluso si Cloud SQL para MySQL no requiere una base de datos para conectarse.
- Los usuarios con contraseñas vacías no son compatibles con Cloud SQL Studio.
USE database
es con estado solo para la ejecución de consulta activa y no funciona de la misma manera que en gcloud CLI.- El usuario de la base de datos debe tener el permiso para conectarse desde el host local.
Cuando se ejecutan varias consultas y una de ellas falla, se muestra el primer error encontrado. Es posible que algunas de las declaraciones del lote antes del error se hayan ejecutado de forma correcta. Puedes unir varias consultas en una declaración
transaction
para evitar este problema:START TRANSACTION; YOUR_SQL_STATEMENTS COMMIT;
Reemplaza lo siguiente:
- YOUR_SQL_STATEMENTS: son las declaraciones que deseas ejecutar como parte de esta consulta.