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.

Cloud SQL Studio valida automáticamente la sintaxis cuando escribes una consulta o seleccionas parte de una consulta.

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.

  7. 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 STATEMENT_TIMEOUT para definir un tiempo de espera de consulta más largo.
  • 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.
  • Si ejecutas varias instrucciones en el editor de consultas al mismo tiempo y una o varias de ellas dan como resultado un error, se cancelará la ejecución de todas las instrucciones y se mostrará el primer error que se haya producido.
  • Cuando Cloud SQL Studio detecta una sintaxis de consulta no válida, genera un registro en postgres.log. Estas entradas aparecen como entradas cloudsqladmin y contienen la consulta no válida, la posición del error de sintaxis y el mensaje de error correspondiente. Para quitar estos registros de la vista, configura filtros de registro para excluir la cloudsqladminbase de datos, el cloudsqladminusuario o ambos.