Versão de documentos XML
Os procedimentos armazenados da API SQL comum suportam múltiplas versões dos três documentos de parâmetros XML: documentos de entrada XML, documentos de saída XML e documentos de mensagem XML.
Se a estrutura, os atributos ou os tipos em um documento de parâmetros XML mudarem, a versão do documento de parâmetros XML mudará. Portanto, o conteúdo do documento de parâmetros XML varia dependendo da versão especificada.
A versão de todos os três documentos permanece sincronizada ao chamar um procedimento armazenado. Por exemplo, se você chamar o procedimento armazenado GET_SYSTEM_INFO e especificar o parâmetro major_version como 1 e o parâmetro minor_version como 1, os documentos de entrada XML, saída XML e mensagem XML serão documentos da Versão 1.1.
<key>Document Type Name</key><string>Data Server Configuration Output</string>
<key>Document Type Major Version</key><integer>2</integer>
<key>Document Type Minor Version</key><integer>0</integer>
Para determinar a versão mais recente suportada do documento para um procedimento armazenado, especifique NULL para o parâmetro major_version, o parâmetro minor_version e todos os outros parâmetros necessários. O procedimento armazenado retorna a versão mais alta suportada do documento como valores nos parâmetros de saída major_version e minor_version e configura os parâmetros de saída xml_output e xml_message como NULL.
Se especificar valores não nulos para os parâmetros major_version e minor_version, você deverá especificar uma versão do documento que seja suportada. Se a versão for inválida, o procedimento armazenado retornará um erro (-20457).
Se o documento de entrada XML no parâmetro xml_input especificar as chaves Document Type Major Version e Document Type Minor Version, o valor para essas chaves deverá ser igual aos valores especificados nos parâmetros major_version e minor_version ou um erro (+20458) será mostrado.