Compartilhar via

Registrar processo de geração (SQLXML 4.0)

  • Artigo

Aplica-se a: Banco de Dados SQL do Azure do SQL Server

O XML Bulk Load processa os dados de entrada XML e prepara registros para as tabelas apropriadas no Microsoft SQL Server. A lógica no XML Bulk Load determina quando gerar um novo registro, quais valores de elemento filho ou atributo copiar para os campos do registro e quando o registro está completo e pronto para ser enviado ao SQL Server para inserção.

O carregamento em massa de XML não carrega todos os dados de entrada XML na memória e não produz conjuntos de registros completos antes de enviar dados para o SQL Server. Isto é porque os dados de entrada XML podem ser um documento grande e carregar o documento inteiro na memória pode ser caro. Em vez disso, o Carregamento em massa XML faz o seguinte:

  1. Analisa o esquema de mapeamento e prepara o plano de execução necessário.

  2. Aplica o plano de execução aos dados no fluxo de entrada.

Esse processamento sequencial torna importante o fornecimento de dados de entrada XML de um modo específico. Você deve entender como o Carregamento em massa XML analisa o esquema de mapeamento e como o processo de geração de registro ocorre. Ao compreender isso, você pode fornecer um esquema de mapeamento ao Carregamento em massa XML que gera os resultados desejados.

O Carregamento em massa XML trata as anotações do esquema de mapeamento comum, incluindo mapeamentos de coluna e tabela (especificados explicitamente, usando anotações, ou implicitamente, através do mapeamento padrão), e relacionamentos de junção.

Observação

Parte-se do pressuposto que você está familiarizado com esquemas de mapeamento anotados XSD ou XDR. Para obter mais informações sobre esquemas, consulte Introdução aos esquemas XSD anotados (SQLXML 4.0) ou Esquemas XDR anotados (preteridos no SQLXML 4.0).

Compreender a geração de registros requer o conhecimento dos seguintes conceitos:

  • Escopo de um nó

  • Regra de geração de registro

  • Subconjunto de registro e regra de ordenação de chaves

  • Exceções à regra de geração de registros

Escopo de um nó

Um nó (um elemento ou um atributo) em um documento XML entra no escopo quando o XML Bulk Load o encontra no fluxo de dados de entrada XML. Para um nó de elemento, a marca inicial do elemento coloca o elemento no escopo. Para um nó de atributo, o nome do atributo coloca o atributo no escopo.

Um nó sai do escopo quando não há mais dados para ele: seja na marca final (no caso de um nó de elemento) ou no final do valor de um atributo (no caso de um nó de atributo).

Regra de geração de registro

Quando um nó (elemento ou atributo) entra no escopo, existe uma possibilidade de geração de um registro a partir desse nó. O registro dura enquanto o nó associado estiver no escopo. Quando o nó sai do escopo, o XML Bulk Load considera o registro gerado completo (com dados) e o envia ao SQL Server para inserção.

Por exemplo, considere o seguinte fragmento de esquema XSD:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
  <xsd:element name="Customer" sql:relation="Customers" >  
   <xsd:complexType>  
     <xsd:attribute name="CustomerID" type="xsd:string" />  
     <xsd:attribute name="CompanyName" type="xsd:string" />  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

O esquema especifica um elemento Customer> com os atributos CustomerID e CompanyName.< A anotação sql:relation mapeia o <elemento Customer> para a tabela Customers.

Considere este fragmento de um documento XML:

<Customer CustomerID="1" CompanyName="xyz" />  
<Customer CustomerID="2" CompanyName="abc" />  
...

Quando um Carregamento em massa XML é fornecido com o esquema descrito nos parágrafos anteriores e os dados XML são fornecidos como entrada, ele processa os nós (elementos e atributos) nos dados de origem, conforme indicado a seguir:

  • A marca start do primeiro <elemento Customer> traz esse elemento no escopo. Este nó é mapeado para a tabela Customers. Portanto, o Carregamento em massa XML gera um registro para a tabela Customers.

  • No esquema, todos os atributos do <elemento Customer> são mapeados para colunas da tabela Customers. À medida que esses atributos entram no escopo, o Carregamento em massa XML copia seus valores para o registro do cliente que já foi gerado pelo escopo pai.

  • Quando o XML Bulk Load atinge a marca final do <elemento Customer> , o elemento sai do escopo. Isso faz com que o XML Bulk Load considere o registro concluído e o envie para o SQL Server.

O carregamento em massa de XML segue esse processo para cada elemento Customer> subsequente<.

Importante

Nesse modelo, como um registro é inserido quando uma marca final é atingida (ou o nó fica fora do escopo), você deve definir todos os dados que estão associados ao registro dentro do escopo do nó.

Subconjunto de registros e a regra de ordenação de chaves

Quando você especifica um esquema de mapeamento que usa <sql:relationship>, o termo de subconjunto refere-se ao conjunto de registros gerado no lado externo da relação. No exemplo a seguir, os registros CustOrder estão no lado externo, <sql:relationship>.

Por exemplo, suponha que um banco de dados contenha as seguintes tabelas:

  • Cust (CustomerID, CompanyName, City)

  • CustOrder (CustomerID, OrderID)

O CustomerID na tabela CustOrder é uma chave estrangeira que faz referência à chave primária CustomerID na tabela Cust.

Agora, considere a exibição XML conforme especificado no seguinte esquema XSD anotado. Esse esquema usa <sql:relationship> para especificar a relação entre as tabelas Cust e CustOrder.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
<xsd:annotation>  
  <xsd:appinfo>  
    <sql:relationship name="CustCustOrder"  
          parent="Cust"  
          parent-key="CustomerID"  
          child="CustOrder"  
          child-key="CustomerID" />  
  </xsd:appinfo>  
</xsd:annotation>  
  
  <xsd:element name="Customers" sql:relation="Cust" >  
   <xsd:complexType>  
     <xsd:sequence>  
       <xsd:element name="CustomerID"  type="xsd:integer" />  
       <xsd:element name="CompanyName" type="xsd:string" />  
       <xsd:element name="City"        type="xsd:string" />  
       <xsd:element name="Order"   
                          sql:relation="CustOrder"  
                          sql:relationship="CustCustOrder" >  
         <xsd:complexType>  
          <xsd:attribute name="OrderID" type="xsd:integer" />  
         </xsd:complexType>  
       </xsd:element>  
     </xsd:sequence>  
    </xsd:complexType>  
  </xsd:element>  
</xsd:schema>

Os dados XML de exemplo e as etapas para criar um exemplo de funcionamento são dados a seguir.

  • Quando um <nó de elemento Customer> no arquivo de dados XML entra no escopo, o XML Bulk Load gera um registro para a tabela Cust. Em seguida, o XML Bulk Load copia os valores de coluna necessários (CustomerID, CompanyName e City) dos elementos filho CustomerID, ><CompanyName> e <City> à medida que esses elementos entram no escopo.<

  • Quando um <nó de elemento Order> entra no escopo, o XML Bulk Load gera um registro para a tabela CustOrder. O XML Bulk Load copia o valor do atributo OrderID para esse registro. O valor necessário para a coluna CustomerID é obtido do elemento filho CustomerID> do <elemento Customer>.< O XML Bulk Load usa as informações especificadas em sql:relationship> para obter o valor da chave estrangeira CustomerID para esse registro, a< menos que o atributo CustomerID tenha sido especificado no elemento Order>.< A regra geral é que, se o elemento filho especificar explicitamente um valor para o atributo de chave estrangeira, o XML Bulk Load usará esse valor e não obterá o valor do elemento pai usando o sql:relationship> especificado<. À medida que esse <nó do elemento Order> sai do escopo, o XML Bulk Load envia o registro para o SQL Server e processa todos os nós do elemento Order> subsequentes <da mesma maneira.

  • Por fim, o <nó do elemento Customer> sai do escopo. Nesse momento, o XML Bulk Load envia o registro do cliente para o SQL Server. O Carregamento em massa XML segue este processo para todos os clientes subsequentes no fluxo de dados XML.

Existem duas observações sobre o esquema de mapeamento:

  • Quando o esquema atende à regra de "contenção" (por exemplo, todos os dados associados ao cliente e o pedido são definidos dentro do escopo dos nós de elemento Customer> e< Order> associados<), o carregamento em massa é bem-sucedido.

  • Ao descrever o <elemento Customer> , seus elementos filho são especificados na ordem apropriada. Nesse caso, o elemento filho CustomerID> é especificado antes do< elemento filho Order>.< Isso significa que, no arquivo de dados XML de entrada, o valor do <elemento CustomerID> está disponível como o valor da chave estrangeira quando o< elemento Order> entra no escopo. Os atributos de chave são especificados primeiro; esta é a “regra de ordenação de chaves".

    Se você especificar o <elemento filho CustomerID> após o <elemento filho Order>, o valor não estará disponível quando o< elemento Order> entrar no escopo. Quando a <tag /Order> end é lida, o registro da tabela CustOrder é considerado completo e é inserido na tabela CustOrder com um valor NULL para a coluna CustomerID, que não é o resultado desejado.

Para criar um exemplo de funcionamento

  1. Salve o esquema fornecido neste exemplo como SampleSchema.xml.

  2. Crie estas tabelas:

    CREATE TABLE Cust (  
              CustomerID     int         PRIMARY KEY,  
              CompanyName    varchar(20) NOT NULL,  
              City           varchar(20) DEFAULT 'Seattle')  
GO  
CREATE TABLE CustOrder (  
             OrderID        int         PRIMARY KEY,  
             CustomerID     int         FOREIGN KEY REFERENCES                                          Cust(CustomerID))  
GO

  3. Salve os dados de entrada XML de exemplo a seguir como SampleXMLData.xml:

    <ROOT>  
  <Customers>  
    <CustomerID>1111</CustomerID>  
    <CompanyName>Hanari Carnes</CompanyName>  
    <City>NY</City>   
    <Order OrderID="1" />  
    <Order OrderID="2" />  
  </Customers>  

  <Customers>  
    <CustomerID>1112</CustomerID>  
    <CompanyName>Toms Spezialitten</CompanyName>  
    <City>LA</City>  
    <Order OrderID="3" />  
  </Customers>  
  <Customers>  
    <CustomerID>1113</CustomerID>  
    <CompanyName>Victuailles en stock</CompanyName>  
    <Order OrderID="4" />  
</Customers>  
</ROOT>

  4. Para executar o XML Bulk Load, salve e execute o seguinte exemplo do Microsoft Visual Basic Scripting Edition (VBScript) (BulkLoad.vbs):

    set objBL = CreateObject("SQLXMLBulkLoad.SQLXMLBulkload.4.0")  
objBL.ConnectionString = "provider=SQLOLEDB;data source=localhost;database=tempdb;integrated security=SSPI"  
objBL.ErrorLogFile = "c:\error.log"  
objBL.CheckConstraints = True  
objBL.Execute "c:\SampleSchema.xml", "c:\SampleXMLData.xml"  
set objBL=Nothing

Exceções à regra de geração de registros

O Carregamento em massa XML não gera um registro para um nó quando ele entra no escopo, se esse nó for do tipo IDREF ou IDREFS. Você deve ter certeza de que há uma descrição completa do registro em algum lugar do esquema. As anotações dt:type="nmtokens" são ignoradas da mesma forma que o tipo IDREFS é ignorado.

Por exemplo, considere o esquema XSD a seguir que descreve os elementos Customer> e <Order>.< O <elemento Customer> inclui um atributo OrderList do tipo IDREFS. A <marca sql:relationship> especifica a relação um-para-muitos entre o cliente e a lista de pedidos.

Este é o esquema:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">  
<xsd:annotation>  
  <xsd:appinfo>  
    <sql:relationship name="CustCustOrder"  
                 parent="Cust"  
                 parent-key="CustomerID"  
                 child="CustOrder"  
                 child-key="CustomerID" />  
  </xsd:appinfo>  
</xsd:annotation>  
  
  <xsd:element name="Customers" sql:relation="Cust" >  
   <xsd:complexType>  
    <xsd:attribute name="CustomerID" type="xsd:integer" />  
    <xsd:attribute name="CompanyName" type="xsd:string" />  
    <xsd:attribute name="City" type="xsd:string" />  
    <xsd:attribute name="OrderList"   
                       type="xsd:IDREFS"   
                       sql:relation="CustOrder"   
                       sql:field="OrderID"  
                       sql:relationship="CustCustOrder" >  
    </xsd:attribute>  
  </xsd:complexType>  
 </xsd:element>  
  
  <xsd:element name="Order" sql:relation="CustOrder" >  
   <xsd:complexType>  
    <xsd:attribute name="OrderID" type="xsd:string" />  
    <xsd:attribute name="CustomerID" type="xsd:integer" />  
    <xsd:attribute name="OrderDate" type="xsd:date" />  
  </xsd:complexType>  
 </xsd:element>  
</xsd:schema>

Como o Carregamento em massa ignora os nós do tipo IDREFS, não há geração de registro quando o nó do atributo OrderList entra no escopo. Portanto, se você quiser que os registros de ordem sejam adicionados à tabela Orders, deve descrever esses pedidos ordens em algum lugar no esquema. Nesse esquema, especificar o elemento Order> garante que o <XML Bulk Load adicione os registros de pedido à tabela Orders. O <elemento Order> descreve todos os atributos necessários para preencher o registro da tabela CustOrder.

Você deve garantir que os valores CustomerID e OrderID no< elemento Customer> correspondam aos valores no< elemento Order.> Você é responsável por manter a integridade referencial.

Para testar um exemplo de funcionamento

  1. Crie estas tabelas:

    CREATE TABLE Cust (  
              CustomerID     int          PRIMARY KEY,  
              CompanyName    varchar(20)  NOT NULL,  
              City           varchar(20)  DEFAULT 'Seattle')  
GO  
CREATE TABLE CustOrder (  
              OrderID        varchar(10) PRIMARY KEY,  
              CustomerID     int         FOREIGN KEY REFERENCES                                          Cust(CustomerID),  
              OrderDate      datetime DEFAULT '2000-01-01')  
GO

  2. Salve o esquema de mapeamento fornecido neste exemplo como SampleSchema.xml.

  3. Salve os dados XML de exemplo a seguir como SampleXMLData.xml:

    <ROOT>  
  <Customers CustomerID="1111" CompanyName="Sean Chai" City="NY"  
             OrderList="Ord1 Ord2" />  
  <Customers CustomerID="1112" CompanyName="Dont Know" City="LA"  
             OrderList="Ord3 Ord4" />  
  <Order OrderID="Ord1" CustomerID="1111" OrderDate="1999-01-01" />  
  <Order OrderID="Ord2" CustomerID="1111" OrderDate="1999-02-01" />  
  <Order OrderID="Ord3" CustomerID="1112" OrderDate="1999-03-01" />  
  <Order OrderID="Ord4" CustomerID="1112" OrderDate="1999-04-01" />  
</ROOT>

  4. Para executar o Carregamento em massa XML, salve e execute esse exemplo de VBScript (SampleVB.vbs):

    set objBL = CreateObject("SQLXMLBulkLoad.SQLXMLBulkload.4.0")  
objBL.ConnectionString = "provider=SQLOLEDB;data source=localhost;database=tempdb;integrated security=SSPI"  
objBL.ErrorLogFile = "c:\error.log"  
objBL.CheckConstraints=True  
objBL.Execute "c:\SampleSchema.xml", "c:\SampleXMLData.xml"  
set objBL=Nothing