Administra tus datos con Cloud SQL Studio

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 una variedad de acciones que harí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:

  • Tables
  • 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 Administrador de Cloud SQL (roles/cloudsql.admin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

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

  • cloudsql.instances.get
  • cloudsql.users.list
  • cloudsql.databases.list
  • cloudsql.instances.executeSql

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 privilegiada 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:

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

    Ir a Instancias de Cloud SQL

  2. Elige una instancia de la lista.
  3. En el menú de navegación, haz clic en Cloud SQL Studio.
  4. 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 por tu cuenta o usar el explorador para propagar el editor de consultas.

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

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

    Ir a Instancias de Cloud SQL

  2. Elige una instancia de la lista.
  3. En el menú de navegación, haz clic en Cloud SQL Studio.
  4. Accede a Cloud SQL con el nombre de tu base de datos, nombre de usuario y contraseña.
  5. Redacta una consulta con uno de los siguientes métodos:
    • Para redactar tu propia consulta, sigue estos pasos:
      1. Abre una pestaña nueva con solo hacer clic en
      2. Escribe tu consulta cuando aparezca el editor de consultas.
    • Para redactar una consulta que comience con una plantilla, sigue estos pasos:
      1. 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.
      2. Haz clic en una acción. El editor de consultas se propaga con una plantilla.
      3. Reemplaza cualquier marcador de posición en la plantilla.
  6. Ejecuta tus consultas con uno de los siguientes enfoques:
    • Para ejecutar todas las instrucciones en el editor de consultas, haz clic en Ejecutar.
    • Para ejecutar declaraciones específicas, selecciona una o varias instrucciones y haz clic en Run selected.
  7. Los resultados de tus consultas aparecen en la pestaña Resultados. Si hay varios conjuntos de resultados disponibles, selecciona uno de los resultados de la lista desplegable Todos los resultados.

Limitaciones

  • Cloud SQL Studio admite consultas ligeras. Las respuestas de más de 8 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 un minuto 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 de editor no comparten una sesión común y cada ejecución comienza 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 de BLOB. Si la secuencia de comandos SQL produce una columna BLOB 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 tiene estado solo para la ejecución de consulta activa y no funciona de la misma manera que en la CLI de gcloud.
  • El usuario de la base de datos debe tener el permiso para conectarse desde el localhost.
  • Cuando se ejecutan varias consultas y una de ellas falla, se muestra el primer error encontrado. Algunas de las declaraciones en el lote anteriores al error podrían haberse ejecutado de forma correcta. Puedes unir varias consultas en una instrucció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.