Создание внешней таблицы с помощью мастера пользовательского веб-интерфейса Azure Data Explorer
Внешняя таблица — это сущность схемы, которая ссылается на данные, хранящиеся за пределами базы данных Azure Data Explorer. Веб-интерфейс Azure Data Explorer может создавать внешние таблицы, используя образцы файлов из контейнера хранилища и создавая схему на основе этих примеров. Затем вы можете анализировать и запрашивать данные из внешних таблиц без необходимости их приема в Azure Data Explorer. Краткий обзор см. в статье Внешние таблицы. Дополнительные сведения о различных способах создания внешних таблиц см. в статье Создание и изменение внешних таблиц службы хранилища Azure. В этой статье показано, как создать внешнюю таблицу с помощью мастера создания.
Предварительные требования
- Подписка Azure. Создайте бесплатную учетную запись Azure.
- Кластер и база данных Azure Data Explorer. Создайте кластер и базу данных.
- Войдите в пользовательский веб-интерфейс Azure Data Explorer и добавьте подключение к кластеру.
Создание внешней таблицы
В меню слева выберите элемент Запрос.
Щелкните правой кнопкой мыши базу данных, в которой нужно создать внешнюю таблицу. Выберите Создать внешнюю таблицу.
Откроется окно Создать внешнюю таблицу с выбранной вкладкой Назначение.
Вкладка назначения
- Поля Кластер и База данных заполняются автоматически. В раскрывающемся меню можно выбрать другое назначение.
- В поле Имя таблицы введите имя таблицы.
Совет
Имена таблиц могут содержать до 1024 символов, включая буквы, цифры, дефисы и символы подчеркивания. Специальные символы не поддерживаются.
- Выберите Далее: Источник.
Вкладка "Источник"
В разделе Связь с контейнерамидоступны два способа добавления контейнера: добавление контейнера с помощью кнопки Выбрать контейнер и добавление контейнера с помощью кнопки "Добавить URL-адрес" или "Добавить контейнер".
Вы можете добавить до 10 исходных контейнеров.
Добавление контейнера с помощью кнопки Выбрать контейнер
Щелкните Выбор контейнера.
Выберите соответствующую подписку и учетную запись хранения, связанную с вашим контейнером.
Нажмите кнопку Добавить. После завершения проверки справа от ссылки на контейнер появится зеленая галочка.
Добавление контейнера с помощью кнопки "Добавить URL-адрес" или "Добавить контейнер"
Нажмите кнопку Добавить URL-адрес или Добавить контейнер.
Введите строки подключения хранилища к исходному контейнеру с разрешениями на чтение и перечисление. После завершения проверки справа от ссылки на контейнер появится зеленая галочка.
Фильтры файлов
Используйте Фильтры файлов для фильтрации файлов, которые должна включать таблица. Файлы можно фильтровать по пути к папке, началу имен файлов или расширению файлов.
Файл для определения схемы
В первом исходном контейнере будут показаны файлы, расположенные в разделе Фильтры файлов.
- Выберите файл, определяющий схему, щелкнув окружность слева от файла. Этот файл будет использоваться для создания схемы таблицы.
- Выберите Далее: схема. Откроется вкладка Схема.
Вкладка Schema (Схема)
В правой части вкладки можно просмотреть данные. В левой части можно добавить разделы в определения таблиц для более быстрого доступа к исходным данным и достижения более высокой производительности.
Примечание
Сопоставления не являются частью определения внешней таблицы и не поддерживаются этим мастером. При необходимости сопоставления можно настроить позднее. Некоторые возможности, например удаление последнего столбца в CSV-файлах или изменение имен столбцов в JSON-файлах, требуют сопоставления для правильной работы.
Выберите Добавить раздел.
Откроется окно разделов. Раздел определяется по вложенному пути файла, который можно изменить с помощью поля Префикс пути. Для каждого раздела, который вы хотите применить, заполните поля следующим образом:
Поле Описание Обязательный/необязательный Имя раздела Используется для идентификации раздела. Имя может быть любым. Обязательно Тип Тип данных в столбце для разделения данных. Обязательно Столбец данных Столбец, используемый для разделения. Виртуальные столбцы разделяют данные на основе URL-адресов. Обязательно Функция Функция, применяемая к столбцу данных, используемому для разделения. Необязательно Аргумент функции Аргумент, используемый в функции разделения. Обязателен при использовании функции. Префикс пути Вложенный путь к файлу, по которому выполняется разделение данных. Этот префикс изменяет URL-адрес внешней таблицы, как показано в поле Предварительный просмотр URI, и должен совпадать с URI файла, определяющего схему. Необязательно Шаблон даты и времени Формат даты, который будет использоваться для создания пути URI таблицы. Необязательно Например, имя раздела CustomerName указывает, что значение, по которому необходимо выполнить разделение, находится в имени клиента в составе URL-адреса. Приведенный выше пример содержит два раздела: один раздел по имени клиента и один раздел по дате в составе URL-адреса.
Примечание
Виртуальные столбцы отображаются как часть схемы, так как данные столбцов извлечены из пути к файлу, и эти данные можно использовать позже в запросах.
Выберите Добавить раздел, чтобы добавить еще один раздел.
Нажмите кнопку Сохранить. Добавленные секции отображаются в списке Разделы в области слева. Столбцы разделения нельзя изменить в предварительной версии.
Нажмите кнопку Далее: создать таблицу. При создании таблицы открывается окно Внешняя таблица успешно создана.
Чтобы просмотреть команду, используемую для создания таблицы, выберите Посмотреть команду.
Чтобы отменить создание внешней таблицы, выберите Средства>Откат.
Запрос к внешней таблице
Результирующая таблица содержит данные из всех файлов, соответствующих заданным выше критериям. Эту таблицу можно опросить с помощью функции external_table()
. Дополнительные сведения о выполнении запросов к внешним таблицам см. в разделе Запросы к внешней таблице.