Usa el modelador visual de grafos de BigQuery

Para solicitar asistencia o proporcionar comentarios sobre esta función, envía un correo electrónico a bq-graph-preview-support@google.com.

En este documento, se describe cómo usar el modelador de gráficos visuales en BigQuery Studio para definir nodos y aristas a partir de tus tablas de BigQuery, y cómo editar y consultar datos de gráficos. También puedes crear un gráfico con la sentencia CREATE PROPERTY GRAPH.

Roles obligatorios

Para obtener los permisos que necesitas para crear y consultar grafos, pídele a tu administrador que te otorgue el rol de IAM de Editor de datos de BigQuery (roles/bigquery.dataEditor) en el conjunto de datos en el que creas las tablas de nodos, las tablas de aristas y el grafo. 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 a través de roles personalizados o cualquier otro rol predefinido.

Crea un gráfico

Para crear un gráfico con el modelador visual, sigue estos pasos:

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

    Ir a BigQuery

  2. Para abrir la galería, en la barra de pestañas del editor, haz clic en la flecha junto a Consulta en SQL y, luego, en Gráfico.

  3. En el campo Nombre del gráfico, ingresa un nombre para el gráfico.

  4. En el campo Gráfico de destino en el conjunto de datos, haz una de las siguientes acciones:

  5. Selecciona las tablas que deseas usar como fuentes de datos.

  6. Haz clic en Crear. BigQuery crea el recurso de gráfico y te dirige al modelador visual.

Cómo ver un gráfico

Para ver un gráfico existente, sigue estos pasos:

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

    Ir a BigQuery

  2. En el panel de navegación, haz clic en Explorador:

  3. En el panel Explorador, expande tu proyecto y haz clic en Conjuntos de datos.

  4. Haz clic en el conjunto de datos que contiene tu gráfico.

  5. Haz clic en la pestaña Gráficos.

  6. Selecciona el gráfico que quieres ver.

Cómo editar un gráfico

Después de crear un gráfico, puedes usar el modelador visual para agregar, editar o quitar nodos y bordes. En las siguientes secciones, se describe cómo editar un gráfico existente.

Administrar nodos

En esta sección, se describe cómo administrar los nodos del gráfico.

Cómo agregar un nodo

Para agregar un nodo, sigue estos pasos. Los cambios que realices no se aplicarán hasta que los publiques.

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

    Ir a BigQuery

  2. En el panel de navegación, haz clic en Explorador:

  3. En el panel Explorador, expande tu proyecto y haz clic en Conjuntos de datos.

  4. Haz clic en el conjunto de datos que contiene tu gráfico.

  5. Haz clic en la pestaña Gráficos.

  6. Selecciona el gráfico que deseas editar.

  7. En la barra de acciones del gráfico, haz clic en Nodo nuevo.

  8. En el panel Agregar nodo, haz clic en Agregar tabla.

  9. En el panel Seleccionar tabla, selecciona la tabla del conjunto de datos que deseas agregar y, luego, haz clic en Agregar.

  10. Haz clic en Editar clave primaria.

  11. Selecciona los campos que deseas usar como claves primarias y, luego, haz clic en Agregar.

  12. Opcional: Haz clic en Agregar etiqueta.

    1. En el campo Nombre, ingresa un nombre para la etiqueta.
    2. En el campo Descripción, ingresa una descripción de la etiqueta.
    3. En el campo Sinónimos, ingresa hasta ocho sinónimos.
    4. Haga clic en Add property.

    5. En el panel Seleccionar campos, selecciona todas las propiedades que deseas agregar a la etiqueta.

      Opcional: Puedes agregar un campo personalizado con una medida. Para obtener más información, consulta Medidas de gráficos.

    6. Haz clic en Agregar.

    7. Haz clic en Listo.

  13. Haz clic en Listo.

Cómo editar un nodo

Para editar un nodo, sigue estos pasos. Los cambios que realices no se aplicarán hasta que los publiques.

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

    Ir a BigQuery

  2. En el panel de navegación, haz clic en Explorador:

  3. En el panel Explorador, expande tu proyecto y haz clic en Conjuntos de datos.

  4. Haz clic en el conjunto de datos que contiene tu gráfico.

  5. Haz clic en la pestaña Gráficos.

  6. Selecciona el gráfico que deseas editar.

  7. En el gráfico, selecciona el nodo que deseas editar.

  8. En la ventana del nodo, haz clic en Editar.

  9. En el panel Edit node, haz clic en Edit primary key.

  10. Selecciona los campos que deseas usar como claves primarias y, luego, haz clic en Agregar.

  11. Opcional: Haz clic en Agregar etiqueta.

    1. En el campo Nombre, ingresa un nombre para la etiqueta.
    2. En el campo Descripción, ingresa una descripción de la etiqueta.
    3. En el campo Sinónimos, ingresa hasta ocho sinónimos.
    4. Haga clic en Add property.
    5. En el panel Seleccionar campos, selecciona todas las propiedades que deseas agregar a la etiqueta.
    6. Haz clic en Agregar.
    7. Opcional: Haz clic en Agregar métrica para agregar un campo personalizado con una métrica, como se describe en Gráfico de métricas.
    8. Haz clic en Listo.

  12. Haz clic en Listo.

Cómo quitar un nodo

Para quitar un nodo, sigue estos pasos. Los cambios que realices no se aplicarán hasta que los publiques.

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

    Ir a BigQuery

  2. En el panel de navegación, haz clic en Explorador:

  3. En el panel Explorador, expande tu proyecto y haz clic en Conjuntos de datos.

  4. Haz clic en el conjunto de datos que contiene tu gráfico.

  5. Haz clic en la pestaña Gráficos.

  6. Selecciona el gráfico que deseas editar.

  7. En el gráfico, selecciona el nodo que deseas quitar.

  8. En la ventana Nodo, haz clic en Quitar.

  9. Haz clic en Borrar.

Administra aristas

En esta sección, se describe cómo administrar las aristas del gráfico.

Agregar una conexión de integración

Para agregar una arista, sigue estos pasos. Los cambios que realices no se aplicarán hasta que los publiques.

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

    Ir a BigQuery

  2. En el panel de navegación, haz clic en Explorador:

  3. En el panel Explorador, expande tu proyecto y haz clic en Conjuntos de datos.

  4. Haz clic en el conjunto de datos que contiene tu gráfico.

  5. Haz clic en la pestaña Gráficos.

  6. Selecciona el gráfico que deseas editar.

  7. En la barra de acciones del gráfico, haz clic en Nueva arista.

  8. En el panel Agregar borde, haz clic en Agregar tabla.

  9. En el panel Seleccionar tabla, selecciona la tabla que deseas usar como fuente de datos y, luego, haz clic en Agregar.

  10. En la lista Nodo fuente, selecciona el nodo que deseas usar como fuente.

  11. Haz clic en Agregar columnas referenciadas en el nodo.

    1. Selecciona los campos a los que deseas hacer referencia.
    2. Haz clic en Agregar.

  12. En la lista Nodo de destino, selecciona el nodo que deseas usar como destino.

  13. Haz clic en Agregar columnas referenciadas en el nodo.

    1. Selecciona los campos a los que deseas hacer referencia.
    2. Haz clic en Agregar.

  14. Haz clic en Agregar columnas referenciadas en el borde.

    1. Selecciona los campos a los que deseas hacer referencia. La cantidad de columnas y los tipos de datos de estas columnas de borde deben coincidir con las columnas a las que se hace referencia seleccionadas para los nodos de origen y destino.
    2. Haz clic en Agregar.

  15. Opcional: Haz clic en Agregar etiqueta.

    1. En el campo Nombre, ingresa un nombre para la etiqueta.
    2. En el campo Descripción, ingresa una descripción de la etiqueta.
    3. En el campo Sinónimos, ingresa hasta ocho sinónimos.
    4. Haga clic en Add property.
    5. En el panel Seleccionar campos, selecciona todas las propiedades que deseas agregar a la etiqueta.
    6. Haz clic en Agregar.
    7. Opcional: Haz clic en Agregar métrica para agregar un campo personalizado con una métrica, como se describe en Gráfico de métricas.
    8. Haz clic en Listo.

  16. Haz clic en Listo.

Cómo editar una conexión de integración

Para editar un borde, sigue estos pasos. Los cambios que realices no se aplicarán hasta que los publiques.

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

    Ir a BigQuery

  2. En el panel de navegación, haz clic en Explorador:

  3. En el panel Explorador, expande tu proyecto y haz clic en Conjuntos de datos.

  4. Haz clic en el conjunto de datos que contiene tu gráfico.

  5. Haz clic en la pestaña Gráficos.

  6. Selecciona el gráfico que deseas editar.

  7. En el gráfico, selecciona la arista que deseas editar.

  8. En la ventana del nodo, haz clic en Editar.

  9. En el panel Editar borde, en la lista Nodo fuente, selecciona el nodo que deseas usar como fuente.

  10. Haz clic en Agregar columnas referenciadas en el nodo.

    1. Selecciona los campos a los que deseas hacer referencia.
    2. Haz clic en Agregar.

  11. En la lista Nodo de destino, selecciona el nodo que deseas usar como destino.

  12. Haz clic en Agregar columnas referenciadas en el nodo.

    1. Selecciona los campos a los que deseas hacer referencia.
    2. Haz clic en Agregar.

  13. Haz clic en Agregar columnas referenciadas en el borde.

    1. Selecciona los campos a los que deseas hacer referencia. La cantidad de columnas y los tipos de datos de estas columnas de borde deben coincidir con las columnas a las que se hace referencia seleccionadas para los nodos de origen y destino.
    2. Haz clic en Agregar.

  14. Opcional: Haz clic en Agregar etiqueta.

    1. En el campo Nombre, ingresa un nombre para la etiqueta.
    2. En el campo Descripción, ingresa una descripción de la etiqueta.
    3. En el campo Sinónimos, ingresa hasta ocho sinónimos.
    4. Haga clic en Add property.
    5. En el panel Seleccionar campos, selecciona todas las propiedades que deseas agregar a la etiqueta.
    6. Haz clic en Agregar.
    7. Opcional: Haz clic en Agregar métrica para agregar un campo personalizado con una métrica, como se describe en Gráfico de métricas.
    8. Haz clic en Listo.

  15. Haz clic en Listo.

Cómo quitar una conexión

Para quitar una arista, sigue estos pasos. Los cambios que realices no se aplicarán hasta que los publiques.

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

    Ir a BigQuery

  2. En el panel de navegación, haz clic en Explorador:

  3. En el panel Explorador, expande tu proyecto y haz clic en Conjuntos de datos.

  4. Haz clic en el conjunto de datos que contiene tu gráfico.

  5. Haz clic en la pestaña Gráficos.

  6. Selecciona el gráfico que deseas editar.

  7. En el gráfico, selecciona la arista que deseas quitar.

  8. En la ventana Nodo, haz clic en Quitar.

  9. Confirma la eliminación.

Publica los cambios del gráfico

Para guardar tus modificaciones, publícalas en el recurso de gráfico. Lleva a cabo los pasos siguientes:

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

    Ir a BigQuery

  2. En el panel de navegación, haz clic en Explorador:

  3. En el panel Explorador, expande tu proyecto y haz clic en Conjuntos de datos.

  4. Haz clic en el conjunto de datos que contiene tu gráfico.

  5. Haz clic en la pestaña Gráficos.

  6. Selecciona el gráfico que deseas editar.

  7. Cuando termines de editar, haz clic en Publicar.

  8. Revisa la declaración CREATE PROPERTY GRAPHen el panel Publicar gráfico y, luego, haz clic en Publicar.

¿Qué sigue?