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 del 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.
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.
- Cloud SQL Studio no admite la autenticación de Active Directory.
- Cloud SQL Studio no es compatible con el comando
GO
. Este comando se usa en las utilidades de Microsoft SQL Server para indicar que un lote de declaraciones finalizó y se puede enviar a SQL Server. Si una consulta incluye una columna binaria, Cloud SQL Studio no puede mostrarla. Convierte los valores binarios en una cadena.
Por ejemplo, reemplaza:
SELECT my_binary_column from my_table2;
con:
SELECT CONVERT(NVARCHAR(4000), my_binary_column, 1) from my_table2;
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:BEGIN TRANSACTION YOUR_SQL_STATEMENTS COMMIT;
Reemplaza lo siguiente:
- YOUR_SQL_STATEMENTS: son las declaraciones que deseas ejecutar como parte de esta consulta.