Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
SQL Server SSIS Integration Runtime em Azure Data Factory
A fonte XML lê um arquivo de dados XML e preenche as colunas na saída de origem com os dados.
Os dados em arquivos XML freqüentemente incluem relações hierárquicas. Por exemplo, um arquivo de dados XML pode representar catálogos e itens em catálogos. Antes que os dados possam entrar no fluxo de dados, a relação dos elementos no arquivo de dados XML deve ser determinada e uma saída deve ser gerada para cada elemento no arquivo.
Esquemas
A fonte XML usa um esquema para interpretar os dados XML. A fonte XML suporta o uso de um arquivo XSD (XML Schema Definition) ou esquemas embutidos para traduzir os dados XML em um formato tabular. Se você configurar a fonte XML usando a caixa de diálogo Editor de código-fonte XML , a interface do usuário poderá gerar um XSD a partir do arquivo de dados XML especificado.
Observação
DTDs não são suportados.
Os esquemas podem suportar apenas um único namespace; eles não suportam coleções de esquema.
Observação
A fonte XML não valida os dados no arquivo XML em relação ao XSD.
Editor de código-fonte XML
Os dados nos arquivos XML freqüentemente incluem relações hierárquicas. A caixa de diálogo Editor de código-fonte XML usa o esquema especificado para gerar as saídas de origem XML. Você pode especificar um arquivo XSD, usar um esquema embutido ou gerar um XSD a partir do arquivo de dados XML especificado. O esquema deve estar disponível em tempo de design.
A fonte XML gera estruturas tabulares a partir dos dados XML criando uma saída para cada elemento que contém outros elementos nos arquivos XML. Por exemplo, se os dados XML representam catálogos e itens em catálogos, a fonte XML cria uma saída para catálogos e uma saída para cada tipo de item que os catálogos contêm. A saída de cada item incluirá colunas de resultados referentes aos atributos desse item.
Para fornecer informações sobre a relação hierárquica dos dados nas saídas, a fonte XML adiciona uma coluna nas saídas que identifica o elemento pai para cada elemento filho. Usando o exemplo de catálogos com diferentes tipos de itens, cada item teria um valor de coluna que identifica o catálogo ao qual pertence.
A fonte XML cria uma saída para cada elemento, mas não é necessário que você use todas as saídas. Você pode excluir qualquer saída que não queira usar ou simplesmente não conectá-la a um componente downstream.
A fonte XML também gera os nomes de saída, para garantir que os nomes sejam inequívocos. Esses nomes podem ser longos e podem não identificar as saídas de uma forma que seja útil para você. Você pode renomear as saídas, desde que seus nomes permaneçam exclusivos. Você também pode modificar o tipo de dados e o comprimento das colunas de saída.
Para cada saída, a fonte XML adiciona uma saída de erro. Por padrão, as colunas nas saídas de erro têm o tipo de dados de cadeia de caracteres Unicode (DT_WSTR) com um comprimento de 255, mas você pode configurar as colunas nas saídas de erro modificando seu tipo de dados e comprimento.
Se o arquivo de dados XML contiver elementos que não estão no XSD, esses elementos serão ignorados e nenhuma saída será gerada para eles. Por outro lado, se o arquivo de dados XML estiver faltando elementos que são representados no XSD, a saída conterá colunas com valores nulos.
Quando os dados são extraídos do arquivo de dados XML, eles são convertidos em um tipo de dados do Integration Services. No entanto, a fonte XML não pode converter os dados XML para os tipos de dados DT_TIME2 ou DT_DBTIMESTAMP2 porque a fonte não oferece suporte a esses tipos de dados. Para obter mais informações, consulte Tipos de dados do Integration Services.
O XSD ou esquema embutido pode especificar o tipo de dados para elementos, mas se isso não acontecer, a caixa de diálogo Editor de código-fonte XML atribui o tipo de dados de cadeia de caracteres Unicode (DT_WSTR) à coluna na saída que contém o elemento e define o comprimento da coluna para 255 caracteres.
Se o esquema especificar o comprimento máximo de um elemento, o comprimento da coluna de saída será definido como esse valor. Se o comprimento máximo for maior do que o comprimento suportado pelo tipo de dados do Integration Services para o qual o elemento é convertido, os dados serão truncados para o comprimento máximo do tipo de dados. Por exemplo, se uma cadeia de caracteres tiver um comprimento de 5000, ela será truncada para 4000 caracteres porque o comprimento máximo do tipo de dados DT_WSTR é de 4000 caracteres; Da mesma forma, os dados de byte são truncados para 8000 caracteres, o comprimento máximo do tipo de dados DT_BYTES. Se o esquema não especificar nenhum comprimento máximo, o comprimento padrão das colunas com qualquer tipo de dados será definido como 255. O truncamento de dados na fonte XML é tratado da mesma forma que o truncamento em outros componentes de fluxo de dados. Para obter mais informações, consulte Tratamento de erros em dados.
Você pode modificar o tipo de dados e o comprimento da coluna. Para obter mais informações, consulte Tipos de dados do Integration Services.
Configuração do código-fonte XML
A fonte XML suporta três modos diferentes de acesso a dados. Você pode especificar o local do arquivo de dados XML, a variável que contém o local do arquivo ou a variável que contém os dados XML.
A fonte XML inclui as propriedades personalizadas XMLData e XMLSchemaDefinition que podem ser atualizadas por expressões de propriedade quando o pacote é carregado. Para obter mais informações, consulte Expressões do Integration Services (SSIS), Utilizar expressões de propriedade em pacotes e Propriedades personalizadas de origem XML.
A fonte XML suporta várias saídas regulares e várias saídas de erro.
O SQL Server Integration Services inclui a caixa de diálogo Editor de código-fonte XML para configurar a fonte XML. Esta caixa de diálogo está disponível no Designer SSIS.
Você pode definir propriedades por meio do SSIS Designer ou programaticamente.
A caixa de diálogo Advanced Editor reflete as propriedades que podem ser definidas programaticamente. Para obter mais informações sobre as propriedades que você pode definir na caixa de diálogo Advanced Editor ou programaticamente, clique em um dos seguintes tópicos:
Para obter mais informações sobre como definir as propriedades, clique em um dos seguintes tópicos:
Editor de código-fonte XML (página do Gerenciador de Conexões)
Use a página Gerenciador de conexões do Editor de código-fonte XML para especificar um arquivo XML e o XSD que transforma os dados XML.
Opções estáticas
Modo de acesso aos dados
Especifique o método para selecionar dados da fonte.
| Valor | Descrição |
|---|---|
| Local do arquivo XML | Recupere dados de um arquivo XML. |
| Arquivo XML da variável | Especifique o nome do arquivo XML em uma variável. Informações relacionadas: Usar variáveis em pacotes |
| Dados XML da variável | Recupere dados XML de uma variável. |
Usar esquema embutido
Especifique se os próprios dados de origem XML contêm o esquema XSD que define e valida sua estrutura e dados.
Localização XSD
Digite o caminho e o nome do arquivo de esquema XSD ou localize o arquivo clicando em Procurar.
Navegar
Use a caixa de diálogo Abrir para localizar o arquivo de esquema XSD.
Gerar XSD
Use a caixa de diálogo Salvar como para selecionar um local para o arquivo de esquema XSD gerado automaticamente. O editor infere o esquema a partir da estrutura dos dados XML.
Opções dinâmicas do modo de acesso a dados
Modo de acesso a dados = local do arquivo XML
Localização XML
Digite o caminho e o nome do arquivo de dados XML ou localize o arquivo clicando em Procurar.
Navegar
Use a caixa de diálogo Abrir para localizar o arquivo de dados XML.
Modo de acesso a dados = arquivo XML da variável
Nome da variável
Selecione a variável que contém o caminho e o nome do arquivo XML.
Modo de acesso a dados = dados XML da variável
Nome da variável
Selecione a variável que contém os dados XML.
Editor de código-fonte XML (Página de Colunas)
Use o nó Colunas da caixa de diálogo Editor de código-fonte XML para associar uma coluna de saída a uma coluna externa (de origem).
Opções
Colunas externas disponíveis
Exiba a lista de colunas externas disponíveis na fonte de dados. Não é possível usar esta tabela para adicionar ou excluir colunas.
Coluna Externa
Exiba colunas externas (fonte) na ordem em que a tarefa as lerá. Você pode alterar essa ordem limpando primeiro as colunas selecionadas na tabela exibida no editor e, em seguida, selecionando colunas externas da lista em uma ordem diferente.
Coluna de saída
Forneça um nome exclusivo para cada coluna de saída. O padrão é o nome da coluna externa (fonte) selecionada; no entanto, você pode escolher qualquer nome exclusivo e descritivo. O nome fornecido será exibido no SSIS Designer.
Editor de código-fonte XML (página de saída de erro)
Use a página Saída de erro da caixa de diálogo Editor de código-fonte XML para selecionar opções de tratamento de erros e definir propriedades em colunas de saída de erro.
Opções
de entrada/saída
Exiba o nome da fonte de dados.
Coluna
Exiba as colunas externas (origem) selecionadas na página Gerenciador de Conexões da caixa de diálogo Editor de código-fonte XML .
Erro
Especifique o que deve acontecer quando ocorrer um erro: ignore a falha, redirecione a linha ou falhe o componente.
Tópicos relacionados:Tratamento de erros em dados
Truncamento
Especifique o que deve acontecer quando ocorrer um truncamento: ignorar a falha, redirecionar a linha ou provocar a falha do componente.
Descrição
Veja a descrição do erro.
Defina esse valor para células selecionadas
Especifique o que deve acontecer com todas as células selecionadas quando ocorrer um erro ou truncamento: ignore a falha, redirecione a linha ou falhe o componente.
Candidatar-se
Aplique a opção de tratamento de erros às células selecionadas.