Запрос к базе данныхQuery Database

Важно!

Эта версия Orchestrator достигла конца поддержки, мы рекомендуем выполнить обновление до Orchestrator 2019.This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

Действие запрос базы данных запрашивает базу данных и возвращает результирующие строки в виде опубликованных данных.The Query Database activity queries a database and returns the resulting rows as published data. Это действие поддерживает следующие типы баз данных:This activity supports the following database types:

  • ДоступAccess

  • ODBCODBC

  • Oracle;Oracle

  • SQL ServerSQL Server

Действие "запрос к базе данных" можно использовать для запроса подробного описания кода ошибки, который появился в одной из систем в центре обработки данных, после чего это описание отправляется администратору в сообщении электронной почты.The Query Database activity can be used to query a database for the detailed description of an error code that has appeared on one of the systems in the data center and then that description is sent to an administrator in an email message.

Настройка действия "запрос к базе данных"Configuring the Query Database Activity

Перед настройкой действия "запрос к базе данных" необходимо определить следующее:Before you configure the Query Database activity you will need to determine the following:

  • База данных, к которой выполняется подключениеThe database that you are connecting to

  • Выполняемый запрос SQLThe SQL query that you are running

Используйте следующие сведения для настройки действия "запрос к базе данных".Use the following information to configure the Query Database activity.

СведенияDetails

"Настройки"Settings Инструкции по настройкеConfiguration Instructions
ЗапросQuery Введите запрос SQL в поле запроса .Type the SQL query in the Query field

Предупреждение

Действие "запрос базы данных" не поддерживает запросы, возвращающие данные в формате XML, например запросы, в которых используется предложение for XML в SQL Server.The Query Database activity does not support queries that return data as XML, such as queries that use the FOR XML clause in SQL Server.

ПодключениеConnection

"Настройки"Settings Инструкции по настройкеConfiguration Instructions
Тип базы данныхDatabase type Выберите тип базы данных из раскрывающегося списка.Select the Database type from the drop-down list. Возможны следующие варианты:The options include the following:

— Доступ- Access
— ODBC- ODBC
— Oracle- Oracle
— SQL Server- SQL Server

Важно!

Если Orchestrator устанавливается в операционной системе, отличной от английской, и установлено соединение для типа базы данных SQL Server, то входное значение сервера не может быть localhost.When Orchestrator is installed on a non-English operating system, and you set the Connection for Database type to SQL Server, the Server input value cannot be localhost. Необходимо использовать фактическое имя компьютера.You must use the actual computer name.

Инструкции по настройке для каждого типа базы данных вкладки подключения перечислены в следующих таблицах.Configuration instructions for each Connection tab Database type are listed in the following tables.

Доступ к подключениямAccess Connections

"Настройки"Settings Инструкции по настройкеConfiguration Instructions
ФайлFile Введите имя файла базы данных Access , к которому требуется получить доступ.Type the name of the Access database file that you want to access.
Файл рабочей группыWorkgroup file Введите имя файла рабочей группы Access , связанного с этой базой данных.Type the name of the Access workgroup file that is associated with this database.
User nameUser name Введите имя пользователя для файла рабочей группы.Type the user name for the workgroup file.
ПарольPassword Введите пароль для файла рабочей группы.Type the password for the workgroup file.
Пароль базы данныхDB password Введите пароль для базы данных Access.Type the password for the Access database.

Подключения ODBCODBC Connections

"Настройки"Settings Инструкции по настройкеConfiguration Instructions
DSNDSN Введите имя источника данных.Enter the data source name.
User nameUser name Введите имя пользователя для этой базы данных.Enter the user name for this database.
ПарольPassword Введите пароль для этой базы данных.Enter the password for this database.

Подключение к OracleOracle Connections

"Настройки"Settings Инструкции по настройкеConfiguration Instructions
имя службы;Service Name Введите имя службы.Enter the service name.
User nameUser name Введите имя пользователя для этой базы данных.Enter the user name for this database.
ПарольPassword Введите пароль для этой базы данных.Enter the password for this database.

Подключения SQL ServerSQL Server Connections

"Настройки"Settings Инструкции по настройкеConfiguration Instructions
АутентификацияAuthentication Выберите проверку подлинности Windows или SQL Server.Select either Windows Authentication or SQL Server Authentication.
ServerServer Введите имя SQL Server, к которому требуется получить доступ.Enter the name of the SQL Server that you want to access.
Исходный каталогInitial catalog Введите имя начального каталога.Enter the name of the initial catalog.

Если выбран параметр Проверка Подлинности SQL Server , введите имя пользователя и пароль, используемые для доступа к SQL Server в полях имя пользователя и пароль .If you selected the SQL Server Authentication option, type the user name and password used to access the SQL Server in the User name and Password boxes.

Время ожиданияTimeout

"Настройки"Settings Инструкции по настройкеConfiguration Instructions
TimeoutTimeout Введите время, в течение которого операция базы данных запросов будет ожидать завершения операции базы данных.Enter the amount of time that the Query Database activity will wait for the database operation to complete.

Задайте для этого параметра значение 0 ожидание в течение неограниченного времени.Set this value to 0 to wait indefinitely.

Учетная запись для безопасного доступаSecurity Credentials

"Настройки"Settings Инструкции по настройкеConfiguration Instructions
Использовать безопасность учетной записи, привязанной к службеUse the security of the account assigned to the service Выберите этот параметр, если требуется выполнить действие запроса базы данных с использованием той же учетной записи, которую использует сервер Runbook.Select this option if you want to run the Query Database activity using the same account that the runbook server uses.
Эта учетная записьThis account Используйте этот параметр, чтобы указать другую учетную запись.Use this option to specify a different account. Введите имя пользователя и пароль.Enter the User name and Password. Примечание. При указании недопустимого имени пользователя или пароля учетная запись, назначенная серверу Runbook, будет использоваться для выполнения действия.Note: If you specify an invalid user name or password, the account assigned to the runbook server will be used to run the activity.

Опубликованные данныеPublished Data

В следующей таблице перечислены опубликованные элементы данных.The following table lists the published data items.

ЭлементItem ОписаниеDescription
Числовое значение, возвращаемое запросомNumeric return value of the query При использовании запроса, возвращающего числовое значение, это значение будет значением.When a query that returns a numeric value is used, this will be the value. Например, "SELECT COUNT (*) WHERE FirstName = John"For example, "Select COUNT(*) where FirstName=John"
Запрос к базе данныхDatabase query Запрос к базе данных, отправленный в базу данных.The database query that was sent to the database.
Исходный каталогInitial Catalog Исходный каталог, который использовался при соединении с базой данных.The initial catalog that was used when connecting to the database. Эти опубликованные данные будут доступны только при выборе SQL Server на вкладке " Подключение ".This published data will only be available when SQL Server is selected on the Connection tab.
Сервер базы данныхDatabase server Имя сервера базы данных.The name of the database server. Эти опубликованные данные будут доступны только при выборе SQL Server на вкладке " Подключение ".This published data will only be available when SQL Server is selected on the Connection tab.
пользователь базы данных;Database user Имя пользователя, используемое для подключения к серверу базы данных.The name of the user used to connect to the database server.
DSN ODBCODBC DSN Имя DSN ODBC.The name of the ODBC DSN. Эти опубликованные данные будут доступны только при выборе ODBC на вкладке Подключение .This published data will only be available when ODBC is selected on the Connection tab.
Имя службы OracleOracle Service Name Имя службы.The service name. Эти опубликованные данные будут доступны только при выборе Oracle на вкладке Подключение .This published data will only be available when Oracle is selected on the Connection tab.
Доступ к файлуAccess file Запрашиваемый файл базы данных Access.The Access database file that was queried. Эти опубликованные данные будут доступны только при выборе доступа на вкладке " Подключение ".This published data will only be available when Access is selected on the Connection tab.
Доступ к файлу сведений рабочей группыAccess workgroup information file Файл рабочей группы Access, связанный с файлом базы данных Access.The Access workgroup file that is associated with the Access database file. Опубликованные ксата будут доступны только при выборе доступа на вкладке Подключение .This published xata will only be available when Access is selected on the Connection tab.
Для каждой опубликованной строкиFor each row published
Полная строка в виде строки с полями, разделенными;Full line as a string with fields separated by ; Вся строка, опубликованная с каждым полем в строке, разделенной точкой с запятой (;).The entire the row that was published with each field in the row separated by a semi-colon (;). Использование функции обработки данных поля для получения значений поля в строкеUse the Field data manipulation function to obtain the values of a field within the row