Ім'я джерела даних (DSN), вказане в аргументі строка_связі, має бути визначено до того, як буде зроблена спроба встановити зв'язок.
Аргумент строка_связі можна ввести як масив або як рядок. Якщо строка_связі перевищує 250 знаків, її необхідно ввести як масив.
Якщо функція SQL.REQUEST не може отримати доступ до даних, використовуючи аргумент строка_связі, то повертається значення помилки # Н / Д.
Показ_драйвера Необов'язковий. Вказує, в яких випадках має виводитися діалогове вікно драйвера і які параметри доступні. Скористайтеся одним із чисел, описаних у наведеній нижче таблиці. Якщо аргумент "показ_драйвера" опущений, функція SQL.REQUEST використовує за замовчуванням значення 2.
Текст_запроса Необов'язковий. Інструкція SQL, яку потрібно виконати в джерелі даних.
Якщо функція SQL.REQUEST не може виконати текст_запроса над вказаним джерелом даних, то повертається значення помилки # Н / Д.
Запит можна оновлювати, зчіплюючи кілька посилань в аргументі текст_запроса. У наступному прикладі функція SQL.REQUEST при кожній зміні осередки $ A $ 3 використовує нове значення для поновлення запиту.
"SELECT Name FROM Customers WHERE Balance>" $ A $ 3 "".
У Microsoft Excel допустимої є довжина рядка до 255 знаків. Якщо текст_запроса перевищує цю довжину, слід ввести запит в вертикальний інтервал осередків і використовувати весь інтервал як текст_запроса. Значення осередків зчіплюються, утворюючи закінчену інструкцію SQL.
Нужни_імена_столбцов Необов'язковий. Вказує, чи повинні імена стовпців повертатися у вигляді першого рядка результату. Задайте для цього аргументу значення ІСТИНА, якщо потрібно, щоб імена стовпців поверталися в першому рядку результату, або значення БРЕХНЯ, якщо вони не потрібні. Якщо аргумент "нужни_імена_столбцов" опущений, функція SQL.REQUEST не повертає імена стовпців.
значення, що повертається
У разі успішного завершення всіх дій функція повертає масив результатів запиту або число рядків, на які подіяв запит.
Якщо функція SQL.REQUEST не може отримати доступ до даних, використовуючи аргумент строка_связі, то повертається значення помилки # Н / Д.
Функція SQL.REQUEST може бути введена як масив. Якщо ввести функцію SQL.REQUEST як масив, буде повернуто масив, який відповідає даному інтервалу.
Якщо інтервал осередків більше, ніж результуючий безліч, функція SQL.REQUEST додає порожні клітинки до поверненню масиву, збільшуючи його до потрібного розміру.
Якщо результуючий безліч більше, ніж інтервал, введений як масив, функція SQL.REQUEST повертає весь отриманий масив.
Порядок аргументів функції SQL.REQUEST відрізняється від порядку аргументів функції SQLRequest в Visual Basic для додатків.
Припустимо, що потрібно зробити запит до бази даних пакета dBASE, яка називається DBASE4. Якщо ввести наступну формулу в клітинку, то буде повернуто масив результатів запиту, причому в першому рядку будуть вказані імена стовпців.
SQL.REQUEST ( "DSN = NWind; DBQ = c: \ msquery; FIL = dBASE4", c15, 2, "Select Custmr_ID, Due_Date from Orders WHERE order_Amt> 100", TRUE)