Модуль community.sap_libs.sap_hdbsql — модуль Ansible для выполнения SQL-запросов в SAP HANA

Примечание

Этот модуль входит в коллекцию community.sap_libs (версия 1.7.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.sap_libs.

Чтобы использовать её в плейбуке, укажите: community.sap_libs.sap_hdbsql.

Добавлено в community.sap_libs 1.0.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль выполняет SQL-операторы в HANA с помощью hdbsql.

Псевдонимы: hana_query

Параметры

Параметр	Комментарии
autocommit boolean	Автоматически фиксировать оператор. Варианты: `false` `true` ← (по умолчанию)
bin_path string	Путь к исполняемому файлу hdbsql.
database string	Укажите базу данных для подключения.
encrypted boolean	Использовать зашифрованное подключение. Варианты: `false` ← (по умолчанию) `true`
filepath list / элементы=path	Один или несколько файлов, каждый из которых содержит один SQL-запрос для выполнения. Должен быть строкой или списком строк.
host string	IP-адрес узла. Также можно указать порт.
instance string / обязательный	Номер экземпляра.
password string	Пароль для подключения к базе данных. Примечание: Поскольку пароли передаются в качестве аргументов командной строки, по возможности следует использовать userstore=true, так как другие пользователи на том же компьютере могут видеть аргументы командной строки.
properties list / элементы=string	Задаёт параметры подключения SQLDBC, например sqlMode=SAPR3 Должен быть строкой или списком строк. Список доступных параметров см. в документации SAP HANA.
query list / элементы=string	SQL-запрос для выполнения. Должен быть строкой или списком строк. Обратите внимание: если передать строку, она будет разделена по запятым (`,`) на элементы списка. Во избежание искажения входных данных лучше передавать одноэлементный список.
sid string	Идентификатор системы.
user string	Имя выделенного пользователя. Пользователь также может быть указан в hdbuserstore. По умолчанию: `"SYSTEM"`
userstore boolean	Если `true`, пользователь должен быть указан в hdbuserstore. Варианты: `false` ← (по умолчанию) `true`

Примечания

Примечание

Не поддерживает check_mode.
При использовании filepath значение changed равно true. При использовании query значение changed равно true, если запрос не является SELECT.
Не используйте флаги оболочки входа (например, ‘become_flags’ со значением ‘-i’), если become_user — администратор SAP.
Если требуется оболочка входа, вручную сбросьте переменные окружения в задаче с помощью ключевого слова environment.

Примеры

- name: Simple select query
  community.sap_libs.sap_hdbsql:
    sid: "hdb"
    instance: "01"
    password: "Test123"
    query: select user_name from users

- name: RUN select query with host port
  community.sap_libs.sap_hdbsql:
    sid: "hdb"
    instance: "01"
    password: "Test123"
    host: "10.10.2.4:30001"
    query: select user_name from users

- name: Run several queries
  community.sap_libs.sap_hdbsql:
    sid: "hdb"
    instance: "01"
    password: "Test123"
    query:
    - select user_name from users
    - select * from SYSTEM
    host: "localhost"
    autocommit: False

- name: Run several queries with path
  community.sap_libs.sap_hdbsql:
    bin_path: "/usr/sap/HDB/HDB01/exe/hdbsql"
    instance: "01"
    password: "Test123"
    query:
    - select user_name from users
    - select * from users
    host: "localhost"
    autocommit: False

- name: Run several queries from file
  community.sap_libs.sap_hdbsql:
    sid: "hdb"
    instance: "01"
    password: "Test123"
    filepath:
    - /tmp/HANA_CPU_UtilizationPerCore_2.00.020+.txt
    - /tmp/HANA.txt
    host: "localhost"

- name: Run several queries from user store
  community.sap_libs.sap_hdbsql:
    sid: "hdb"
    instance: "01"
    user: hdbstoreuser
    userstore: true
    query:
    - select user_name from users
    - select * from users
    autocommit: False

- name: Run query with SQLDBC connect options
  community.sap_libs.sap_hdbsql:
    sid: "hdb"
    instance: "01"
    password: "Test123"
    query: select user_name from users
    properties:
      - "sqlMode=SAPR3"
      - "sslHostNameInCertificate=hana.example.com"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
query_result list / элементы=list	Список с результатами всех выполненных запросов (для каждого запроса — отдельный вложенный список). Возвращается: при успешном выполнении Пример: `[[{"Column": "Value1"}, {"Column": "Value2"}], [{"Column": "Value1"}, {"Column": "Value2"}]]`

Авторы

Rainer Leber (@rainerleber)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/sap_libs/sap_hdbsql_module.html