Exemplo de Esquema de Arquivo¶

Introdução¶

Se você já tiver um arquivo disponível que contenha a estrutura de dados que deseja usar, poderá usar esse arquivo de amostra para definir um esquema em uma transformação. Depois que um arquivo de amostra é carregado, ele se torna um esquema personalizado que você pode editar no editor de esquema para um esquema simples personalizado ou esquema hierárquico personalizado.

Esta opção é semelhante a fornecer o esquema durante a configuração de uma atividade. No entanto, um esquema fornecido durante a configuração da atividade não pode ser editado depois de carregado.

Use um Arquivo de Amostra¶

Para poder definir um esquema usando um arquivo de amostra em uma transformação, primeiro crie uma transformação.

A opção Definir Esquema fica visível somente quando uma transformação ainda não está herdando um esquema de uma atividade adjacente ou de uma atividade inicialmente adjacente que já foi removida. Os esquemas nessas atividades têm precedência sobre um esquema definido em uma transformação.

Desde que esta condição seja atendida, o botão Definir Esquema será exibido no modo de mapeamento em cada lado da transformação que ainda não possui um esquema definido em uma atividade. Clique em Definir Esquema no lado de origem ou destino da transformação e selecione Usar Arquivo de Amostra:

Configurar um Esquema de Arquivo de Exemplo¶

O editor de esquema é aberto. No editor de esquema, selecione Usar esquema salvo ou Fornecer novo esquema. Cada uma dessas opções é abordada abaixo.

Usar Esquema Salvo¶

Escolha Usar esquema salvo para selecionar um esquema existente que foi definido anteriormente no projeto atual. Quando esta opção é selecionada, estas opções ficam disponíveis:

• Esquemas salvos: Use o menu suspenso para selecionar um esquema existente para reutilizar.

• Visualizar esquema: Depois que um esquema existente carregado for selecionado, você poderá visualizar o esquema diretamente na área de texto abaixo do menu suspenso. Para visualizar o esquema em uma área maior, clique no ícone popout (após abrir essa área, clique no ícone de retorno para voltar a esta tela).

  Embora um esquema salvo não seja editável, esta área de texto pode ser copiada usando Control+C (Windows ou Linux) ou Command+C (macOS).

  Esta área de texto é apenas para a exibição de esquemas carregados existentes e não exibe flat, hierárquico ou espelhado esquemas personalizados.

• Validação: As informações de validação são fornecidas abaixo da área de texto e são baseadas na extensão do arquivo do esquema salvo.

• Esquema de visualização: Uma visualização do esquema é exibida à direita. O esquema é exibido usando os elementos de interface padrão descritos em Nós e Campos.

• Salvar alterações: Este botão não é utilizável, pois não é possível fazer alterações em um esquema salvo a partir do editor de esquema. Para fazer alterações em um esquema salvo, use a opção Edit Schema disponível em um menu de ações do esquema.

• Concluir: Clique para salvar a seleção do esquema e fechar o editor de esquema.

• Cancelar: Clique para fechar o editor de esquema.

Fornecer Novo Esquema¶

Escolha Fornecer novo esquema para definir um novo esquema carregando um de um URL, fazendo upload de um arquivo ou inserindo um manualmente na área de texto. Quando esta opção é selecionada, estas opções ficam disponíveis:

• Nome do esquema: Insira um nome para o esquema na caixa de texto superior, incluindo a extensão do arquivo (.csv, .json, .xml, .xsd, ou .zip). Se nenhuma extensão de arquivo for fornecida, o conteúdo será analisado para detectar automaticamente o tipo de arquivo a ser usado para validação. Se você estiver carregando o esquema de um URL ou fazendo upload de um arquivo, poderá deixar em branco, pois o nome será preenchido assim que o arquivo for carregado.

• Carregar URL: Clique para abrir uma caixa de diálogo onde você pode carregar um esquema de um URL:

  

  • Tipo de arquivo: Use o menu suspenso para selecionar entre os tipos de arquivo suportados, incluindo CSV, JSON, XML, XSD e FECHO ECLAIR. Tome nota:

    • XSD: Um XSD fornecido por URL pode importar/incluir outros URLs XSD por referência.

    • ZIP: Um arquivo ZIP pode conter uma coleção de XSDs, que podem importar/incluir uns aos outros por referência. Quaisquer arquivos não XSD no arquivo serão ignorados. Vários níveis de diretório são suportados.

  • URL: Insira uma URL que seja acessível sem autenticação. Arquivos de até 5 MB podem ser carregados.

  • Carregar: Clique para carregar o esquema do URL. Observe que o arquivo é recuperado apenas uma vez para geração de esquema. Além disso, esteja ciente de que alguns dados podem ser convertidos durante o processamento conforme descrito em Processamento de Esquema.

  • Cancelar: Clique para fechar a caixa de diálogo Upload Schema URL sem salvar.

• Carregar arquivo: Clique para abrir uma caixa de diálogo onde você pode carregar um esquema de um arquivo que pode ser acessado na máquina atual:

  

  • Tipo de arquivo: Use o menu suspenso para selecionar entre os tipos de arquivo suportados, incluindo CSV, JSON, XML, XSD e FECHO ECLAIR.

    Nota

    Um arquivo ZIP pode conter uma coleção de XSDs, que podem importar/incluir uns aos outros por referência. Quaisquer arquivos não XSD no arquivo serão ignorados. Vários níveis de diretório são suportados.

  • Arquivo: Use o botão Procurar à direita para navegar até um arquivo que ainda não foi usado no projeto atual. Arquivos de até 5 MB podem ser carregados.

  • Carregar: Clique para carregar o esquema do arquivo. Observe que alguns dados podem ser convertidos durante o processamento conforme descrito em Processamento de Esquema.

  • Cancelar: Clique para fechar a caixa de diálogo Carregar arquivo de esquema sem salvar.

• Visualizar/Editar esquema: Se você não estiver fazendo upload de um esquema, poderá inseri-lo manualmente na área de texto abaixo dos botões Carregar URL e Carregar arquivo. Caso contrário, após fazer upload de um esquema, você poderá visualizar ou editar o esquema diretamente nessa área de texto.

  Para visualizar ou editar o esquema em uma área maior, clique no ícone popout (após abrir essa área, clique no ícone de retorno para voltar a esta tela).

  Esta área de texto também pode ser copiada usando Control+C (Windows ou Linux) ou Command+C (macOS).

• Validação: À medida que você edita um esquema, as informações de validação são fornecidas abaixo da área de texto, com quaisquer erros relatados uma linha por vez. Ou seja, depois de resolver um erro em uma linha, erros de sintaxe adicionais a serem resolvidos poderão ser relatados nas linhas subsequentes. A validação é baseada na extensão de arquivo do esquema fornecido.

• Esquema de visualização: Uma visualização do esquema é exibida à direita. Depois de carregar um novo esquema ou fazer edições na área de texto à esquerda, você deve primeiro clicar no botão Salvar alterações para que as alterações sejam refletidas na área de visualização. O esquema é exibido usando os elementos de interface padrão descritos em Nós e Campos.

• Salvar alterações: Clique para salvar o esquema e atualizar a visualização do esquema mostrada no lado direito.

  Aviso

  Se você tentar fazer upload de um arquivo com o mesmo nome de um arquivo existente já definido no projeto, uma caixa de diálogo perguntará se você deseja substituir o arquivo existente. Se você clicar em Continuar, o arquivo será substituído pelo novo arquivo com o mesmo nome em todos os locais onde for usado no projeto. Se não quiser substituir o arquivo, clique em Cancelar e modifique manualmente o arquivo para que ele tenha um nome que ainda não esteja sendo usado e tente salvá-lo novamente.

  

  Nota

  Ao fazer upload de um arquivo XSD que contém vários elementos de nível superior, ao clicar em Salvar alterações, você será solicitado a selecionar o nó raiz desejado. Selecione o elemento desejado e clique em Concluir para salvar:

  

• Concluir: Clique para salvar o esquema e fechar o editor de esquema.

• Cancelar: Clique para fechar o editor de esquema.

  Nota

  Se você já usou o botão Salvar alterações, as alterações já foram salvas e usar Cancelar apenas fecha a configuração. Usar Cancel sem primeiro usar Save Changes fecha o editor de esquema sem salvar.

Menu de Ações do Esquema¶

Após a criação de um esquema do arquivo de amostra, você poderá acessar opções de menu adicionais que estão disponíveis para todos os esquemas.

Isso inclui Excluir, Renomear, Exibir dependências, Implantar, Implantação configurável e Adicionar ao grupo, bem como Editar esquema e Limpar esquema. Para obter detalhes sobre essas ações, consulte Menu Ações do esquema.