Создание преобразования SQL из текстового запроса

Можно использовать Помощник SQL для создания преобразований из текстового запроса, в котором описано требуемое преобразование. Например, можно выбирать столбцы, объединять таблицы и фильтровать записи.

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

Текстовый запрос и информация о наборе данных отправляются в стороннюю модель генеративного искусственного интеллекта (GenAI) для создания SQL-кода. Информация обрабатывается как клиентские данные и не будет использоваться для обучения Qlik Cloud или модели GenAI на платформе AWS Bedrock. Для получения дополнительной информации см. раздел Предоставляемая информация.

Доступность

Модель GenAI размещается на сервере AWS Bedrock Anthropic в том же регионе, что и клиент Qlik Cloud. Помощник SQL доступен в клиентах в следующих регионах Qlik:

• Восток США (Северная Виргиния)

• Азиатско-Тихоокеанский регион (Сидней)

• Европа (Франкфурт)

• Европа (Ирландия)

Помощник SQL должен быть включен на уровне клиента администратором клиента в Администрирование.

• Включите Помощник SQL на основе генеративного ИИ, выбрав Параметры > Контроль функции.

Создание запроса SQL с помощью Помощника SQL

Помощник SQL доступен в разделе преобразований SQL в задачах «Преобразование данных». Необходимо предварительно добавить хотя бы один набор данных в преобразование SQL.

Для получения дополнительной информации о преобразованиях SQL см. раздел Добавление преобразований SQL.

1. Щелкните Помощник SQL.

   Открывается Помощник SQL со строкой для ввода текста.

2. В поле Запрос ведите описание преобразования, которое требуется получить.

   Пример: перечислить всех клиентов с объемом продаж больше 5 миллионов. Укажите общий объем продаж и общий объем возможностей для каждого клиента.

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

3. Щелкните Создать.

4. Проверьте созданный запрос SQL, который отображается SQL.

   Можно оценить результаты, щелкнув или . Это поможет Qlik улучшить работу с Помощником SQL.

   Если созданное преобразование недостаточно точное или требуется что-то изменить, щелкните Редактировать запрос, внесите изменения в текстовый запрос и создайте новый запрос SQL.

5. Получив желаемый запрос SQL, щелкните Применить, чтобы скопировать его в преобразование SQL.

6. Нажмите Извлечь параметры.

7. Щелкните Описать таблицу.

8. Проверьте полученный набор данных в разделе Результаты. Также можно щелкнуть Просмотреть данные, чтобы просмотреть образец данных результатов.

9. Получив желаемые результаты, нажмите кнопку «ОК» и примените преобразование SQL.

Предоставляемая информация

Для создания запроса модели генеративного ИИ передается следующая информация.

• Текстовый запрос

• Дополнительные инструкции по созданию запроса, чтобы адаптировать его для целевой платформы данных.
  Пример: создать запрос SQL с использованием синтаксиса, совместимого с Snowflake

• Имена и описания наборов данных.

• Имена, типы данных и размеры столбцов

• Столбцы первичных ключей (уникальные идентификаторы).

• Отношения между наборами данных

  Пример: order_detail присоединяется к order с использованием ключа order_id.

Ограничения использования

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

• Один вызов: 18 тыс. токенов.

  Если это количество превышено, удалите ненужные наборы данных или введите менее сложное описание в поле текстового запроса.

• Ежедневно (на клиент): 1 млн токенов

• Ежемесячно (на клиент): 10 млн токенов

При расчете использования токен представляет 6 символов. Вызов модели генеративного ИИ включает следующее:

• Общие инструкции по созданию запроса SQL. Этот компонент имеет фиксированный размер.

• Текстовый запрос.

• Схематическое представление метаданных в наборах данных. Этот компонент может быть очень большим, если выбрано большое количество наборов данных.

Ограничения

• Инкрементное создание SQL не поддерживается. Для получения дополнительной информации см. раздел Добавление преобразований SQL.

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

• Независимые от платформы функции, такие как $CONCAT), не используются.

Рекомендации

• Убедитесь, что модель данных в исходных наборах данных включает все необходимые отношения, когда связанные столбцы имеют разные имена. В общем, модель генеративного ИИ будет связывать столбцы с одинаковыми именами без определения отношения.

  Например: когда столбец ShipVia в Orders должен быть связан со столбцом shipper_id в Shippers, необходимо создать отношения в модели данных перед созданием преобразования SQL.

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

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

  Пример: cus_ct содержит набор данных Customers.