Руководство по быстрому запуску: Создайте свой первый граф в Microsoft Fabric

Замечание

Эта функция сейчас доступна в общедоступной предварительной версии. Эта предварительная версия предоставляется без соглашения на уровне обслуживания и не рекомендуется для продуктивных нагрузок. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Дополнительные сведения см. в разделе Supplemental Terms of Use for Microsoft Azure Previews.

В этом кратком руководстве вы используете граф в Microsoft Fabric для создания базового графа с двумя узлами и одним краем, а затем выполните запрос. Этот процесс занимает около 15 минут.

Полный учебник, охватывающий полную модель данных Adventure Works и более сложные сценарии, см. в руководстве по графу.

Предпосылки

Перед началом работы с этим кратким руководством убедитесь, что:

  1. У вас есть доступ к емкости Microsoft Fabric (F2 или выше) или пробной версии Fabric.

  2. Graph доступен в вашем регионе.

  3. Администратор Fabric включил граф в клиенте Fabric. Они позволяют включить этот параметр на портале администрирования.

    Снимок экрана административного портала с переключателем включения графа в клиенте Fabric.

  4. Вы являетесь членом рабочей области Fabric или имеете разрешение на создание элементов в рабочей области. Дополнительные сведения см. в разделе Workspaces в Microsoft Fabric.

    Это важно

    Управление доступом графа ограничено рабочей областью, в которую она размещается. Пользователи за пределами рабочей области не могут получить доступ к графу. Пользователи в рабочей области, имеющие доступ к базовым данным в Lakehouse, могут моделировать и запрашивать граф.

Подсказка

Если модель Graph (предварительная версия) не отображается в меню +Создать элемент , попросите администратора Fabric включить граф на портале администрирования.

Загрузка примеров данных

Чтобы создать граф, сначала загрузите примеры данных в lakehouse в рабочей области Fabric.

Загрузка образца данных

  1. Перейдите к примерным наборам данных для графов GQL на GitHub.

  2. Выберите файлadventureworks_docs_sample.zip и скачайте его на локальный компьютер.

    Подсказка

    Чтобы скачать файл из GitHub, выберите файл и щелкните значок Скачать raw файл.

  3. Извлеките скачанный файлadventureworks_docs_sample.zip в папку на локальном компьютере.

    Подсказка

    В проводнике щелкните правой кнопкой мыши ZIP-файл и выберите команду "Извлечь все", а затем выберите целевую папку.

Создание озера

  1. В Microsoft Fabric выберите рабочую область.

  2. Выберите +Создать элемент.

  3. Выберите Хранилище данных>Озеро данных.

  4. Введите имя (например, AdventureWorksLakehouse), очистите параметр схемы Lakehouse и нажмите кнопку "Создать".

    Это важно

    Graph в настоящее время не поддерживает lakehouses с включенными схемами Lakehouse.

Загрузка данных в таблицы

Для этого краткого руководства вам потребуется только две таблицы: adventureworks_customers и adventureworks_orders. Отправьте полный пример папки данных и загрузите только эти две таблицы.

Замечание

Вы можете отправить всю папку, если вы планируете выполнить полный учебник позже или хотите изучить дополнительные данные.

  1. В Lakehouse наведите указатель мыши на Файлы, выберите многоточие (...), а затем выберите Загрузить>Загрузить папку.
  2. Перейдите к извлеченной папке и отправьте ее. Это действие загружает все образцы файлов данных в lakehouse.
  3. Разверните Файлы и загруженную папку, чтобы просмотреть подпапки. Для этого краткого руководства вам нужно загрузить в виде таблиц только два из них.
  4. Наведите указатель мыши на вложенную папку adventureworks_customers, нажмите на многоточие (...) и выберите "Загрузить в таблицы>". Затем выберите Новая таблица.
  5. Задайте тип файла Parquet и выберите "Загрузить".
  6. Повторите шаги 4-5 для подпапки adventureworks_orders.

Создание модели графа

  1. В рабочей области Microsoft Fabric выберите + Новый элемент.

  2. Выберите Анализ и обучение данных>Модель графа (предварительная версия).

    Снимок экрана: меню нового элемента с параметром выбора модели Graph (предварительная версия).

    Подсказка

    Кроме того, введите "graph" в поле поиска и нажмите клавишу ВВОД , чтобы найти элементы графа.

  3. Введите имя (например, MyFirstGraph) и нажмите кнопку "Создать".

После создания модели графа вы перейдете в представление графа, в котором можно увидеть, что для режима по умолчанию задано значение Model with Save, Get data, Add node и Add edge button at the top.

Добавление данных в модель графа

Чтобы добавить данные в модель графа, выполните следующие действия в представлении графа:

  1. Выберите Получить данные.

  2. В каталоге OneLake выберите lakehouse, содержащий данные Adventure Works.

  3. Нажмите кнопку "Добавить".

  4. Выберите таблицы adventureworks_customers и adventureworks_orders , а затем нажмите кнопку "Загрузить".

    Снимок экрана: диалоговое окно получения данных с выбранными таблицами.

Определение структуры графа

Теперь, когда данные загружены, определите структуру графа, добавив узлы и края. В этом кратком руководстве вы добавите два типа узлов (Customer и Order) и один граничный тип (purchases), чтобы моделировать связь между клиентами и их заказами.

Добавление двух узлов

  1. Выберите Добавить узел.

  2. Настройте первый узел:

    • Метка: Customer
    • Таблица сопоставления: adventureworks_customers
    • Идентификатор столбца сопоставления: CustomerID_K

    Снимок экрана: диалоговое окно добавления узла в граф.

  3. Нажмите кнопку "Подтвердить".

  4. Снова нажмите кнопку "Добавить узел ".

  5. Настройте второй узел:

    • Метка: Order
    • Таблица сопоставления: adventureworks_orders
    • Идентификатор столбца сопоставления: SalesOrderDetailID_K
  6. Нажмите кнопку "Подтвердить".

Добавление одного края

  1. Выберите Добавить ребро.

  2. Настройте граничный узел:

    • Метка: purchases
    • Таблица сопоставления: adventureworks_orders
    • Исходный узел: Customer
    • Столбец сопоставления источников: CustomerID_FK
    • Целевой узел: Order
    • Столбец целевого сопоставления: SalesOrderDetailID_K

    Снимок экрана, показывающий диалоговое окно добавления ребра.

  3. Нажмите кнопку "Подтвердить".

  4. Нажмите кнопку "Сохранить", чтобы загрузить граф. Загрузка может занять несколько минут. При успешной загрузке графа отображаются метки узла и края на холсте представления графа.

Выполните запрос к вашему графу

Выполните запрос GQL, чтобы найти пять лучших клиентов по количеству заказов.

  1. Выберите режим запроса .

    Снимок экрана: выбор режима запроса и редактора кода.

  2. Выберите редактор кода в верхнем меню.

  3. Введите следующий запрос GQL в поле ввода:

    MATCH (c:Customer)-[:purchases]->(o:`Order`)
    RETURN c.fullName AS customer_name, count(o) AS num_orders
    GROUP BY customer_name
    ORDER BY num_orders DESC
    LIMIT 5
    
  4. Выберите Запустить запрос. Вы увидите пять строк с именами клиентов и их подсчетами заказов, отсортированные от большинства до наименьших заказов.

На следующем рисунке показан запрос GQL и его результаты:

Снимок экрана: результат выполнения запроса GQL.

Поздравляю! Вы создали первый граф в Microsoft Fabric и выполнили запрос к нему.

Дальнейшие шаги