Поделиться через


Создание внешней таблицы с помощью мастера пользовательского веб-интерфейса Azure Data Explorer

Внешняя таблица — это сущность схемы, которая ссылается на данные, хранящиеся за пределами базы данных Azure Data Explorer. Веб-интерфейс Azure Data Explorer может создавать внешние таблицы, используя образцы файлов из контейнера хранилища и создавая схему на основе этих примеров. Затем вы можете анализировать и запрашивать данные из внешних таблиц без необходимости их приема в Azure Data Explorer. Краткий обзор см. в статье Внешние таблицы. Дополнительные сведения о различных способах создания внешних таблиц см. в статье Создание и изменение внешних таблиц службы хранилища Azure. В этой статье показано, как создать внешнюю таблицу с помощью мастера создания.

Предварительные требования

Создание внешней таблицы

  1. В меню слева выберите элемент Запрос.

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

    Снимок экрана: параметр создания внешней таблицы на странице запроса.

Откроется окно Создать внешнюю таблицу с выбранной вкладкой Назначение.

Вкладка назначения

  1. Поля Кластер и База данных заполняются автоматически. В раскрывающемся меню можно выбрать другое назначение.
  2. В поле Имя таблицы введите имя таблицы.

    Совет

    Имена таблиц могут содержать до 1024 символов, включая буквы, цифры, дефисы и символы подчеркивания. Специальные символы не поддерживаются.

  3. Выберите Далее: Источник.

Снимок экрана: вкладка «Назначение» с полями «Кластер», «База данных» и «Таблица».

Вкладка "Источник"

В разделе Связь с контейнерамидоступны два способа добавления контейнера: добавление контейнера с помощью кнопки Выбрать контейнер и добавление контейнера с помощью кнопки "Добавить URL-адрес" или "Добавить контейнер".

Вы можете добавить до 10 исходных контейнеров.

Добавление контейнера с помощью кнопки Выбрать контейнер

  1. Щелкните Выбор контейнера.

    Снимок экрана: кнопка

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

    Снимок экрана: окно выбора контейнера.

  3. Нажмите кнопку Добавить. После завершения проверки справа от ссылки на контейнер появится зеленая галочка.

    Снимок экрана: ссылка на проверенный контейнер.

Добавление контейнера с помощью кнопки "Добавить URL-адрес" или "Добавить контейнер"

  1. Нажмите кнопку Добавить URL-адрес или Добавить контейнер.

    Снимок экрана: кнопка

  2. Введите строки подключения хранилища к исходному контейнеру с разрешениями на чтение и перечисление. После завершения проверки справа от ссылки на контейнер появится зеленая галочка.

    Снимок экрана: добавление подписанного URL-адреса.

Фильтры файлов

Используйте Фильтры файлов для фильтрации файлов, которые должна включать таблица. Файлы можно фильтровать по пути к папке, началу имен файлов или расширению файлов.

Снимок экрана: выбор файла, определяющего схему.

Файл для определения схемы

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

Снимок экрана: вкладка «Создание источника внешней таблицы» в Azure Data Explorer.

  1. Выберите файл, определяющий схему, щелкнув окружность слева от файла. Этот файл будет использоваться для создания схемы таблицы.
  2. Выберите Далее: схема. Откроется вкладка Схема.

Вкладка Schema (Схема)

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

Примечание

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

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

    Снимок экрана: файл представления внешней таблицы в Azure Data Explorer.

  2. Откроется окно разделов. Раздел определяется по вложенному пути файла, который можно изменить с помощью поля Префикс пути. Для каждого раздела, который вы хотите применить, заполните поля следующим образом:

    Поле Описание Обязательный/необязательный
    Имя раздела Используется для идентификации раздела. Имя может быть любым. Обязательно
    Тип Тип данных в столбце для разделения данных. Обязательно
    Столбец данных Столбец, используемый для разделения. Виртуальные столбцы разделяют данные на основе URL-адресов. Обязательно
    Функция Функция, применяемая к столбцу данных, используемому для разделения. Необязательно
    Аргумент функции Аргумент, используемый в функции разделения. Обязателен при использовании функции.
    Префикс пути Вложенный путь к файлу, по которому выполняется разделение данных. Этот префикс изменяет URL-адрес внешней таблицы, как показано в поле Предварительный просмотр URI, и должен совпадать с URI файла, определяющего схему. Необязательно
    Шаблон даты и времени Формат даты, который будет использоваться для создания пути URI таблицы. Необязательно

    Снимок экрана: добавление разделов во внешнюю таблицу в Azure Data Explorer.

    Например, имя раздела CustomerName указывает, что значение, по которому необходимо выполнить разделение, находится в имени клиента в составе URL-адреса. Приведенный выше пример содержит два раздела: один раздел по имени клиента и один раздел по дате в составе URL-адреса.

    Примечание

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

  3. Выберите Добавить раздел, чтобы добавить еще один раздел.

  4. Нажмите кнопку Сохранить. Добавленные секции отображаются в списке Разделы в области слева. Столбцы разделения нельзя изменить в предварительной версии.

    Снимок экрана: Azure Data Explorer с внешней таблицей схемы.

  5. Нажмите кнопку Далее: создать таблицу. При создании таблицы открывается окно Внешняя таблица успешно создана.

  6. Чтобы просмотреть команду, используемую для создания таблицы, выберите Посмотреть команду.

    Снимок экрана: успешное создание внешней таблицы в Azure Data Explorer.

  7. Чтобы отменить создание внешней таблицы, выберите Средства>Откат.

Запрос к внешней таблице

Результирующая таблица содержит данные из всех файлов, соответствующих заданным выше критериям. Эту таблицу можно опросить с помощью функции external_table(). Дополнительные сведения о выполнении запросов к внешним таблицам см. в разделе Запросы к внешней таблице.

Снимок экрана: результаты из таблицы в результате запроса к внешней таблице в Azure Data Explorer.