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

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

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

Предпосылки

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

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

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

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

    Это важно

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

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

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

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

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

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

    Подсказка

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

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

    Подсказка

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

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

  1. В Microsoft Fabric выберите рабочую область, в которой нужно создать lakehouse.
  2. Выберите +Создать элемент.
  3. Выберите Хранилище данных>Озеро данных.
  4. Введите имя (например, AdventureWorksLakehouse), очистите параметр схемы Lakehouse и нажмите кнопку "Создать".

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

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

Замечание

Полный набор примеров файлов используется в полном руководстве по графу. Их также можно использовать для изучения дополнительных данных самостоятельно.

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

По завершении вы увидите две таблицы в разделе "Таблицы " на панели обозревателя lakehouse.

Снимок экрана: таблицы adventureworks_customers и adventureworks_orders.

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

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

  2. Введите граф в поле поиска, нажмите Enter, чтобы найти элементы графа, и выберите Модель графа. Либо прокрутите вниз до Анализ и обучение данных>Модель графа.

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

  3. Введите имя модели графа, например AdventureWorksGraph, и нажмите кнопку "Создать".

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

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

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

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

  1. На верхней ленте выберите "Получить данные".

  2. В каталоге OneLake выберите озеро-хранилище с данными Adventure Works.

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

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

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

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

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

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

  1. На верхней ленте выберите "Добавить узел".

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

    • Метка узла: Customer
    • Исходная таблица: adventureworks_customers
    • Ключ: CustomerID_K

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

  3. Выберите +Добавить свойство, добавьте все столбцы и применить. Этот шаг делает все столбцы в этой исходной таблице доступными в качестве свойств для узла.

    Снимок экрана: диалоговое окно добавления узла в граф с четырьмя свойствами.

  4. Нажмите кнопку "Создать". Вы увидите, как на холсте графа появляется узел Customer.

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

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

    • Метка узла: Order
    • Исходная таблица: adventureworks_orders
    • Ключ: SalesOrderDetailID_K

  7. Выберите +Добавить свойство, добавьте все столбцы и применить. Этот шаг делает все столбцы в этой исходной таблице доступными в качестве свойств для узла.

  8. Нажмите кнопку "Создать".

Теперь на холсте графика видны два узла: Customer и Order.

Снимок экрана: два новых узла на холсте.

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

  1. На верхней ленте выберите "Добавить край".

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

    • Метка Edge: purchases
    • Исходная таблица: adventureworks_orders
    • Узел источника: Customer
    • Ключ источника: CustomerID_FK
    • Целевой узел: Order
    • Целевой ключ: SalesOrderDetailID_K

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

  3. Выберите +Добавить свойство, добавьте все столбцы и применить. Этот шаг делает все столбцы в этой исходной таблице доступными в качестве свойств для края.

  4. Нажмите кнопку "Создать".

  5. На верхней ленте нажмите кнопку "Сохранить".

На холсте представления графа отображаются метки узлов и рёбер.

Снимок экрана: новый край между двумя узлами на холсте.

Данные могут занять несколько минут, чтобы завершить загрузку. Подождите, пока надпись Загрузка данных выполняется не изменится на Загрузка данных завершена..., прежде чем переходить к следующему разделу.

Снимок экрана: сообщение подтверждения о завершении загрузки данных.

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

Выполните запрос 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.

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

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

  • Last updated on