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

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

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

• Подписка Azure. Создайте бесплатную учетную запись Azure.
• Кластер и база данных Azure Data Explorer. Создайте кластер и базу данных.
• Войдите в пользовательский веб-интерфейс Azure Data Explorer и добавьте подключение к кластеру.

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

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

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

   

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

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

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

   Совет

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

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

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

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

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

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

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

   

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

   

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

   

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

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

   

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

   

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

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

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

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

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

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

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

Примечание

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

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

   

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

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

   

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

   Примечание

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

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

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

   

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

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

   

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

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

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

См. также

• Общие сведения о внешних таблицах
• Создание и изменение внешних таблиц службы хранилища Azure
• Функция external_table()
• Руководство. Изучение распространенных операторов