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.instances.login
(solo es obligatorio si usas la autenticación de la base de datos de IAM)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.
Cómo autenticarse en Cloud SQL Studio
Para poder acceder a una base de datos en Cloud SQL Studio, primero debes seleccionar un método de autenticación de la base de datos. Para acceder a tu base de datos con Cloud SQL Studio, puedes usar uno de los siguientes tipos de autenticación:
Autenticación de la base de datos de IAM. El uso de este tipo de autenticación te permite acceder a tu base de datos y a Cloud SQL Studio sin tener que administrar una contraseña adicional. También puedes aprovechar la autenticación de grupos de IAM y administrar el acceso y los privilegios de la base de datos de varios usuarios de tu organización al mismo tiempo.
Autenticación de bases de datos integrada. Para conectarte a la base de datos en Cloud SQL Studio, usa tu cuenta de usuario y credenciales de PostgreSQL.
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.
- 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.
- 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.