Gestionar tus datos con Cloud SQL Studio

En esta página se describe cómo explorar y gestionar los datos de Cloud SQL con Cloud SQL Studio en la consola de Google Cloud .

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 a los datos y manipularlos. Puede realizar una serie de acciones que haría en un cliente de línea de comandos de 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. Puedes ejecutar instrucciones 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 con el editor de consultas de Cloud SQL Studio.

Puede usar el panel Explorador para ver los objetos de la base de datos e interactuar con ellos. Puedes crear, modificar y eliminar objetos de la base de datos, como los siguientes:

  • Tablas
  • Columnas
  • Índices y claves
  • Functions

También puedes usar el panel Explorador para inicializar SELECT consultas de tablas.

Si no has usado nunca Cloud SQL, consulta el resumen de Cloud SQL.

Roles y permisos necesarios

Para obtener los permisos que necesitas para completar las tareas de este documento, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Usuario de Cloud SQL Studio (roles/cloudsql.studioUser) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Para usar Cloud SQL Studio, debes tener los siguientes permisos:

  • cloudsql.databases.list
  • cloudsql.instances.executeSql
  • cloudsql.instances.get
  • cloudsql.instances.login (solo es necesario si usas la autenticación de bases de datos de gestión de identidades y accesos)
  • cloudsql.users.list

Además, asegúrate de que tienes permisos a nivel de base de datos para la base de datos que vas a usar para la autenticación y la contraseña del usuario de la base de datos con privilegios que vas a usar.

Autenticarse en Cloud SQL Studio

Para acceder a una base de datos en Cloud SQL Studio, primero debe seleccionar un método de autenticación de base de datos. Para iniciar sesión en tu base de datos con Cloud SQL Studio, puedes usar uno de los siguientes tipos de autenticación:

Explora tus datos

Para acceder al panel Explorador, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Selecciona una instancia de la lista.
  3. En el menú de navegación, haz clic en Cloud SQL Studio.
  4. Inicia sesión en Cloud SQL Studio con el nombre de tu base de datos, el nombre de usuario y la contraseña. En el panel Explorador se muestra una lista de los objetos de tu base de datos.

Crear, modificar y consultar datos

Con el editor de SQL, puedes ejecutar una combinación de instrucciones DDL, DML y DQL. Puedes redactar una consulta o rellenar el editor de consultas con una plantilla mediante el explorador.

Para estructurar, modificar o consultar tus datos, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Selecciona una instancia de la lista.
  3. En el menú de navegación, haz clic en Cloud SQL Studio.
  4. Inicia sesión en Cloud SQL Studio con el nombre de tu base de datos, el nombre de usuario y la contraseña.
  5. Redacta una consulta con uno de estos métodos:
    • Para redactar tu propia consulta, sigue estos pasos:
      1. Abre una pestaña nueva haciendo clic en .
      2. Cuando aparezca el editor de consultas, escribe la consulta.
    • Para redactar una consulta a partir de una plantilla, sigue estos pasos:
      1. En el panel Explorador, junto a un objeto de base de datos o una colección, haz clic en more_vert Ver acciones. Aparecerán una o varias acciones disponibles.
      2. Haz clic en una acción. El editor de consultas se rellena con una plantilla.
      3. Sustituye los marcadores de posición de la plantilla.

  6. Ejecuta tus consultas con uno de estos métodos:

    • Para ejecutar todas las instrucciones del editor de consultas, haz clic en Ejecutar.
    • Para ejecutar instrucciones específicas, selecciona una o varias instrucciones y haz clic en Ejecutar selección.

    • Los resultados de tus consultas aparecen en la pestaña Resultados. Si hay varios conjuntos de resultados disponibles, selecciona 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 en instancias de Cloud SQL que estén en funcionamiento.
  • Cloud SQL Studio no admite servidores externos.
  • Las solicitudes que tarden más de cinco minutos se cancelarán. No se admite el uso de SET SESSION MAX_EXECUTION_TIME para definir un tiempo de espera de consulta más largo. En Cloud SQL para MySQL 5.6 y 5.7, si se agota el tiempo de espera de las instrucciones DDL de larga duración, es posible que se creen archivos o tablas huérfanos que no se puedan 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 haya completado 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 nueva sesión.
  • Cuando ejecutas una combinación de instrucciones DML, DQL y DDL, solo se muestran los resultados de las consultas 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 SELECT en datos BLOB. Si la secuencia de comandos SQL genera una columna BLOB en la salida, la secuencia de comandos SQL falla y se produce un error.
  • Los comandos de cliente de Cloud SQL para MySQL no se admiten y no se pueden ejecutar en Cloud SQL Studio.
  • El usuario root no se admite en Cloud SQL Studio.
  • Cloud SQL Studio siempre requiere una base de datos, aunque Cloud SQL para MySQL no la requiera para conectarse.
  • Cloud SQL Studio no admite usuarios con contraseñas vacías.
  • USE database solo tiene estado durante la ejecución de la consulta activa y no funciona igual que en la CLI de gcloud.
  • El usuario de la base de datos debe tener permiso para conectarse desde localhost.

  • Cuando se ejecutan varias consultas y una de ellas falla, se devuelve el primer error que se produce. Es posible que algunas de las instrucciones del lote anteriores al error se hayan ejecutado correctamente. Puedes envolver varias consultas en una instrucción transaction para evitar este problema:

    START TRANSACTION;
    YOUR_SQL_STATEMENTS
COMMIT;

    Haz los cambios siguientes:

    • YOUR_SQL_STATEMENTS: las instrucciones que quieras ejecutar como parte de esta consulta