Esta página describe cómo explorar y administrar sus datos de Cloud SQL mediante Cloud SQL Studio en el Google Cloud consola.
Cloud SQL Studio permite a los usuarios autorizados interactuar directamente con la base de datos SQL y ejecutar consultas SQL desde la Google Cloud Consola para acceder y manipular datos. Puede realizar diversas acciones que realizaría en un cliente de línea de comandos SQL, como crear tablas e índices, modificar tablas o configurar vistas.
Cloud SQL Studio incluye un panel Explorador que se integra con un editor de consultas y una tabla de resultados de consultas SQL. Puede ejecutar sentencias DDL, DML y DQL desde esta interfaz. Por ejemplo, en lugar de configurar una herramienta de consulta de bases de datos de terceros, puede crear una tabla y consultar sus datos mediante el editor de consultas de Cloud SQL Studio.
Puede usar el panel Explorador para ver e interactuar con los objetos de su base de datos. Puede crear, modificar y eliminar objetos de la base de datos, como los siguientes:
- Tablas
- Columnas
- Índices y claves
- Funciones
También puede utilizar el panel del Explorador para iniciar consultas SELECT
para tablas.
Si no estás familiarizado con Cloud SQL, consulta la descripción general de Cloud SQL .
Roles y permisos necesarios
Para obtener los permisos necesarios para completar las tareas de este documento, solicite a su administrador que le otorgue el rol de IAM " Usuario de Cloud SQL Studio" ( roles/cloudsql.studioUser
) en el proyecto. Para obtener más información sobre la concesión de roles, consulte "Administrar el acceso a proyectos, carpetas y organizaciones" .
También es posible que puedas obtener los permisos necesarios a través de roles personalizados u otros roles predefinidos .
Para utilizar Cloud SQL Studio, debe tener los siguientes permisos:
-
cloudsql.databases.list
-
cloudsql.instances.executeSql
-
cloudsql.instances.get
-
cloudsql.instances.login
(solo es necesario si utiliza la autenticación de base de datos IAM) -
cloudsql.users.list
Además, asegúrese de tener permisos de nivel de base de datos para la base de datos que está utilizando para la autenticación, y la contraseña para el usuario privilegiado de la base de datos que está utilizando.
Autenticarse en Cloud SQL Studio
Para poder acceder a una base de datos en Cloud SQL Studio, primero debe seleccionar un método de autenticación. Para iniciar sesión en su base de datos con Cloud SQL Studio, puede usar uno de los siguientes tipos de autenticación:
Autenticación de base de datos IAM . Este tipo de autenticación le permite iniciar sesión en su base de datos y en Cloud SQL Studio sin tener que administrar una contraseña adicional. También puede aprovechar la autenticación de grupo IAM y administrar el acceso y los privilegios a la base de datos para varios usuarios de su organización simultáneamente.
Autenticación de base de datos integrada . Se conecta a la base de datos en Cloud SQL Studio con su cuenta de usuario y credenciales de MySQL.
Explora tus datos
Para acceder al panel del Explorador , siga estos pasos:
En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .
- Seleccione una instancia de la lista.
- En el menú de navegación, haga clic en Cloud SQL Studio .
- Inicie sesión en Cloud SQL Studio con el nombre de su base de datos, su nombre de usuario y su contraseña. El panel Explorador muestra una lista de los objetos de su base de datos.
Crea, modifica y consulta tus datos
Con el editor SQL, puede ejecutar una combinación de sentencias DDL, DML y DQL. Puede crear una consulta usted mismo o rellenar el editor de consultas con una plantilla mediante el explorador.
Para estructurar, modificar o consultar sus datos, siga estos pasos:
En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .
- Seleccione una instancia de la lista.
- En el menú de navegación, haga clic en Cloud SQL Studio .
- Inicie sesión en Cloud SQL Studio con el nombre de su base de datos, nombre de usuario y contraseña.
- Redacte una consulta utilizando uno de los siguientes métodos:
- Para redactar tu propia consulta, sigue estos pasos:
- Abra una nueva pestaña haciendo clic en .
- Cuando aparezca el editor de consultas, escriba su consulta.
- Para componer una consulta a partir de una plantilla, siga estos pasos:
- En el panel Explorador , junto a un objeto o colección de base de datos, haga clic en more_vert Ver acciones . Aparecerán una o más acciones disponibles.
- Haga clic en una acción. El editor de consultas se rellena con una plantilla.
- Reemplace cualquier marcador de posición en la plantilla.
- Para redactar tu propia consulta, sigue estos pasos:
- Ejecute sus consultas utilizando cualquiera de los siguientes enfoques:
- Para ejecutar todas las declaraciones en el editor de consultas, haga clic en Ejecutar .
- Para ejecutar declaraciones específicas, seleccione una o varias declaraciones y haga clic en Ejecutar seleccionadas .
- Los resultados de sus consultas aparecen en la pestaña Resultados . Si hay varios conjuntos de resultados disponibles, seleccione uno en 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 cuándo se devuelven resultados parciales.
- Solo puedes ejecutar consultas para instancias de Cloud SQL que estén en ejecución.
- Cloud SQL Studio no admite servidores externos.
- Las solicitudes que tardan más de cinco minutos se cancelan. No se admite establecer un tiempo de espera de consulta mayor con
SET SESSION MAX_EXECUTION_TIME
. En Cloud SQL para MySQL 5.6 y 5.7, el tiempo de espera de las sentencias DDL de larga duración puede causar archivos o tablas huérfanos que no se pueden revertir de forma segura. Tenga cuidado con consultas comoALTER TABLE
en tablas grandes. - Cloud SQL Studio no mantiene abierta la conexión a la base de datos tras la ejecución de un script SQL. De igual forma, las pestañas del editor no comparten una sesión común y cada ejecución inicia una nueva sesión.
- Cuando se ejecuta una combinación de declaraciones DML, DQL y DDL, solo se mostrarán los resultados de las consultas DQL.
- Cerrar el navegador o alguna pestaña del mismo 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
SELECT
en datosBLOB
. Si el script SQL genera una columnaBLOB
en la salida, genera 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
solo tiene estado para la ejecución de consultas activas y no funciona del mismo modo que en la CLI de gcloud . - El usuario de la base de datos debe tener permiso para conectarse desde el host local.
Al ejecutar varias consultas y una de ellas falla, se devuelve el primer error detectado. Es posible que algunas de las sentencias del lote anterior al error se hayan ejecutado correctamente. Puede encapsular varias consultas en una sentencia
transaction
para evitar este problema:START TRANSACTION; YOUR_SQL_STATEMENTS COMMIT;
Reemplace lo siguiente:
- YOUR_SQL_STATEMENTS : las sentencias que desea ejecutar como parte de esta consulta