Использование ADO для выполнения запросов SQLXML 4.0

Область применения:SQL ServerAzure SQL Database

В предыдущих версиях SQLXML выполнение запросов по HTTP поддерживалось с помощью виртуальных каталогов SQLXML в IIS и ISAPI-фильтра SQLXML. В SQLXML 4.0 эти компоненты были удалены, так как аналогичные и перекрывающиеся функции предоставляются собственными веб-службами XML, начиная с SQL Server 2005 (9.x).

В качестве альтернативы можно выполнять запросы и использовать SQLXML 4.0 с приложениями на основе COM, используя расширения SQLXML для объектов данных ActiveX (ADO), которые появились в компонентах доступа к данным (MDAC) версии 2.6 и более поздних.

В этом разделе демонстрируется использование SQLXML и ADO в составе приложения Visual Basic Scripting Edition (VBScript) (скрипта с расширением имени VBS-файла). Обеспечивает начальную процедуру установки, которая помогает создать повторно и тестировать образцы запросов в документации SQLXML 4.0.

Создание тестового скрипта SQLXML 4.0

В этой процедуре создается файл VBScript (.vbs), Sqlxml4test.vbs, который можно использовать для выполнения запросов SQLXML с использованием ADO-расширений SQLXML в ADO 2.6 и более поздних версий.

Создание испытателя запросов SQLXML 4.0 с использованием ADO (VBScript)

1. Скопируйте следующий код и вставьте его в текстовый файл. Сохраните файл с именем Sqlxml4test.xml.

   WScript.Echo "Query process may take a few seconds to complete. Please be patient."  
   
   ' Note that for SQL Server Native Client to be used as the data provider,  
   ' it needs to be installed on the client computer first. Also, SQLXML extensions   
   ' for ADO are used and available in MDAC 2.6 or later.  
   
   'Set script variables.  
   inputFile = "@@FILE_NAME@@"  
   strServer = "@@SERVER_NAME@@"  
   strDatabase = "@@DATABASE_NAME@@"  
   dbGuid = "{5d531cb2-e6ed-11d2-b252-00c04f681b71}"  
   
   ' Establish ADO connection to SQL Server and   
   ' create an instance of the ADO Command object.  
   Set conn = CreateObject("ADODB.Connection")  
   Set cmd = CreateObject("ADODB.Command")  
   conn.Open "Provider=SQLXMLOLEDB.4.0;Data Provider=SQLNCLI11;Server=" & strServer & _  
             ";Database=" & strDatabase & ";Integrated Security=SSPI"  
   Set cmd.ActiveConnection = conn  
   
   ' Create the input stream as an instance of the ADO Stream object.  
   Set inStream = CreateObject("ADODB.Stream")  
   inStream.Open  
   inStream.Charset = "utf-8"  
   inStream.LoadFromFile inputFile  
   
   ' Set ADO Command instance to use input stream.  
   Set cmd.CommandStream = inStream  
   
   ' Set the command dialect.  
   cmd.Dialect = dbGuid  
   
   ' Set a second ADO Stream instance for use as a results stream.   
   Set outStream = CreateObject("ADODB.Stream")  
   outStream.Open  
   
   ' Set dynamic properties used by the SQLXML ADO command instance.   
   cmd.Properties("XML Root").Value = "ROOT"  
   cmd.Properties("Output Encoding").Value = "UTF-8"  
   
   ' Connect the results stream to the command instance and execute the command.  
   cmd.Properties("Output Stream").Value = outStream  
   cmd.Execute , , 1024  
   
   ' Echo cropped/partial results to console.  
   WScript.Echo Left(outStream.ReadText, 1023)  
   
   inStream.Close  
   outStream.Close  
   

2. Обновите следующие значения скриптов для образца, который предстоит протестировать, и тестовой среды.

   • Найдите @@FILE_NAME@@ и замените его именем файла шаблона.

   • Найдите @@SERVER_NAME@@ и замените его именем экземпляра SQL Server (например, (local) если SQL Server работает локально).

   • Найдите "@@DATABASE_NAME@@" и замените его именем базы данных (например, AdventureWorks2022 или tempdb).

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

3. Сохраните файл и закройте его.

4. Проверьте, что созданы все дополнительные файлы, такие как XML-шаблоны или схемы, которые являются частью образца, который нужно локально создать повторно на компьютере. Эти файлы должны находиться в том же каталоге, в котором сохранен файл тестового скрипта (Sqlxml4test.vbs).

5. Следуйте инструкциям следующего раздела по использованию тестового скрипта SQLXML 4.0.

Использование тестового скрипта SQLXML 4.0

Следующая процедура описывает способ использования файлов Sqlxml4test.vbs для тестирования примеров запросов, предоставленных в этой документации.

Использование испытателя запросов SQLXML 4.0

1. Убедитесь, что установлен собственный клиент SQL Server, как показано ниже.

   1. В меню "Пуск" наведите указатель мыши на параметры и нажмите кнопку "Панель управления".

   2. На панели управления откройте окно "Добавление и удаление программ"

   3. В списке установленных в настоящее время программ убедитесь, что в списке отображается собственный клиент Microsoft SQL Server.

      Заметка

      Если необходимо установить собственный клиент SQL Server, см. раздел "Установка собственного клиента SQL Server".

2. Проверьте, что на клиентском компьютере установлена версия MDAC 2.6 или более поздняя. Если вам нужно проверить сведения о версии MDAC, можно использовать средство проверки компонентов MDAC, которое предоставляется как бесплатная загрузка с веб-сайта Майкрософт. http://www.microsoft.com Чтобы получить дополнительные сведения, выполните поиск с ключевыми словами «MDAC Component Checker» на веб-сайте корпорации Майкрософт.

3. Выполните скрипт.

   Файл VBScript можно выполнить из командной строки с использованием Cscript.exe или дважды щелкнув файл Sqlxml4test.vbs, чтобы вызвать сервер скриптов Windows (WScript.exe).

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