Создание внешней таблицы с помощью мастера пользовательского веб-интерфейса 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. Выберите Далее: схема. Откроется вкладка Схема.

Вкладка Схема

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

Примечание.

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

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

   

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

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

   

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

   Примечание.

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

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

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

   

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

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

   

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

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

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

Связанный контент

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