Consulta tus datos

El editor de SQL unificado de la extensión del IDE de Google Cloud Data Agent Kit te permite ejecutar consultas en SQL en tus datos de Google Cloud directamente desde tu IDE.

Si usas el complemento Data Agent Kit con un agente de codificación compatible, puedes ejecutar consultas en SQL en el agente o usar instrucciones en lenguaje natural para generar consultas en SQL.

Fuentes de datos compatibles

Data Agent Kit te permite consultar tablas y vistas en los siguientes servicios de datos deGoogle Cloud :

• BigQuery
• Bigtable
• Spanner
• AlloyDB para PostgreSQL
• Cloud SQL para MySQL
• Cloud SQL para PostgreSQL

En el caso de Cloud SQL, se admiten las consultas que usan la autenticación de base de datos de Identity and Access Management (IAM) y la autenticación de base de datos integrada (con contraseñas almacenadas como secretos regionales en Secret Manager). Para obtener más información sobre cómo Cloud SQL autentica a los usuarios integrados con Secret Manager, consulta Ejecuta sentencias de SQL con la API de Data para Cloud SQL para MySQL y Cloud SQL para PostgreSQL. En el caso de AlloyDB, solo se admiten las consultas que usan la autenticación de la base de datos de IAM.

Antes de comenzar

Antes de consultar tus datos, haz lo siguiente:

1. Instala la extensión.
2. Configura los parámetros de la extensión.
3. Revisa la guía en Cómo encontrar y explorar datos.

Crea un archivo SQL nuevo

Puedes abrir el editor de SQL de varias maneras.

Crea un archivo SQL nuevo desde el menú Archivo

1. En la barra de menú de VS Code, haz clic en File y, luego, en New Text File. Aparece un archivo sin título en el editor.
2. Guarda el archivo nuevo con la extensión .sql.
3. Haz clic en Seleccionar una fuente de datos en la pestaña del editor.
4. Completa los pasos en Configura los parámetros de configuración de la consulta.

Crea una consulta nueva desde el catálogo

1. En la pestaña Google Cloud Data Agent Kit de la barra de actividades, expande Catalog para encontrar el conjunto de datos que deseas consultar.
2. Haz clic con el botón derecho o presiona Ctrl y haz clic en el nombre del conjunto de datos. Luego, selecciona Consulta para abrir un nuevo archivo SQL preconfigurado para ese conjunto de datos.

Crea una consulta nueva desde la sección BigQuery

1. En la pestaña Google Cloud Data Agent Kit de la barra de actividades, expande BigQuery.
2. Haz clic en + Nueva consulta. En el editor, aparece un archivo SQL sin título configurado con BigQuery como su fuente de datos.

Configura los parámetros de búsqueda

Los parámetros de configuración necesarios para tu consulta en SQL varían según el Google Cloud servicio.

AlloyDB

1. En el editor de SQL, haz clic en Abrir configuración de consulta.
2. Selecciona Bases de datos.
3. Selecciona AlloyDB.
4. Selecciona un clúster.
5. Selecciona una instancia. Tu consulta se enruta a esta instancia.
6. Selecciona una base de datos.
7. Haz clic en Guardar.

BigQuery

1. En el editor de SQL, haz clic en Abrir configuración de consulta.
2. Selecciona BigQuery.
3. Haz clic en Guardar.

Bigtable

1. En el editor de SQL, haz clic en Abrir configuración de consulta.
2. Selecciona Bases de datos.
3. Selecciona Bigtable.
4. Selecciona una instancia.
5. Opcional: Para usar un perfil de app que no sea el predeterminado, selecciónalo.
6. Redacta tu consulta.
7. Haz clic en Guardar.

Cloud SQL

1. En el editor de SQL, haz clic en Abrir configuración de consulta.
2. Selecciona Bases de datos.
3. Selecciona Cloud SQL.
4. Selecciona una instancia. Tu consulta se enruta a esta instancia.
5. Selecciona una base de datos para consultar.

6. En Método de autenticación, selecciona cómo autenticarte:

   • Autenticación de la base de datos de IAM: Autentícate con tu cuenta de Google Cloud .

   • Autenticación integrada de la base de datos: Autentícate como un usuario integrado de la base de datos cuya contraseña se almacena como un secreto regional en Secret Manager.

     1. En la lista Usuario, selecciona un usuario de la base de datos. Si no se puede cargar la lista, ingresa el nombre de usuario en el campo Usuario. En Cloud SQL para MySQL, no se admite el usuario root predeterminado.
     2. En la lista Contraseña (almacenada en Secret Manager), selecciona el secreto regional que almacena la contraseña del usuario. Si aún no tienes un secreto, selecciona Crear un secreto nuevo en la región REGION, ingresa un Nombre y la Contraseña, y, luego, haz clic en Crear secreto. El secreto se crea en la misma región que tu instancia.
     3. Opcional: En la lista Versión del Secret, selecciona una versión específica. De forma predeterminada, se selecciona latest, que siempre usa la versión más reciente del secreto.

     Para obtener más información sobre los requisitos integrados del usuario y del secreto regional, consulta Ejecuta sentencias de SQL con la API de Data para Cloud SQL para MySQL y Cloud SQL para PostgreSQL.

7. Haz clic en Guardar.

Spanner

1. En el editor de SQL, haz clic en Abrir configuración de consulta.
2. Selecciona Bases de datos.
3. Selecciona Spanner.
4. Selecciona una instancia. Tu consulta se enruta a esta instancia.
5. Selecciona una base de datos para consultar.
6. Haz clic en Guardar.

Cómo cambiar la configuración de la búsqueda

La configuración de las consultas es específica de cada archivo SQL. Después de abrir un archivo SQL, puedes cambiar la configuración.

1. En el editor, haz clic en la fuente de datos que se muestra. Aparecerá el editor de Configuración de la consulta.
2. Completa los pasos en Configura los parámetros de configuración de la consulta.

Ejecuta una consulta

Después de crear un archivo de consulta y redactar tu consulta, haz clic en ▷ Ejecutar consulta.

En la pestaña Resultados del panel Resultados de la consulta, se muestran los resultados de la consulta.

Para ejecutar un subconjunto de las sentencias de SQL en el editor de consultas, destaca el subconjunto antes de hacer clic en ▷ Ejecutar consulta.

Funciones del editor de SQL

No todas las funciones del editor de SQL son compatibles con todos los tipos de fuentes de datos. En la siguiente tabla, se enumeran las funciones del editor de SQL que se admiten por tipo de fuente de datos durante la versión preliminar.

Función	BigQuery	Bigtable	Spanner	Cloud SQL	AlloyDB para PostgreSQL
Resultados de la consulta	✅	✅	✅	✅	✅
Información del trabajo	No aplicable	No aplicable	No aplicable	No aplicable	No aplicable
Detalles de la ejecución	✅	✅ Tiempo transcurrido	❌ No compatible	❌ No compatible	❌ No compatible
Visualización	✅	✅	✅	✅	✅
Configuración de la consulta	✅	✅	✅	✅	✅
Compatibilidad con consultas de varias instrucciones	✅	✅	✅	✅	✅
Catálogo: Inserta el nombre del recurso en el editor	✅	✅	✅	✅	✅

¿Qué sigue?

• Transformar datos
• Cómo solucionar problemas