Vinculando a Objetos no Armazenamento na Nuvem

No cartão do carrinho de compras de links de dados, clique em Definições para abrir o painel Vincular Dados do Cloud Storage desse job. O painel contém:

• Guia Configurações - Seção Tabela
• Guia Configurações - Seção Propriedades
• Guia Configurações - Seção Mapeamento
• Guia Arquivo
• Guia Tabela
• Guia SQL
• Botão Fechar - Salvar e Fechar o Painel

Guia Configurações - Seção Tabela

Defina detalhes sobre a tabela de destino na seção Tabela.

• Nome: O nome da tabela de destino.

• Coluna de Partição:

  Partições de Lista e partições baseadas em Data são os diferentes tipos de partições disponíveis na vinculação de dados.

  O particionamento de lista é necessário quando você deseja mapear linhas especificamente para partições com base em valores discretos.

  Para particionar de acordo com uma coluna específica, clique na lista drop-down Coluna da Partição e selecione a coluna que deseja usar para o particionamento.

  Você terá N arquivos por valor de partição, todos particionados pela coluna de partição selecionada.

  Observação
  
  

  • Para arquivos vinculados (de tabelas externas), há também um requisito de que, para cada arquivo, a coluna de particionamento da lista possa conter apenas um único valor distinto em todas as linhas.
  • Se um arquivo for particionado em lista, a chave de particionamento só poderá consistir em uma única coluna da tabela.

  O particionamento baseado em data está disponível quando você vincula uma pasta que contém duas ou mais origens de dados que têm colunas que contêm dados de data ou timestamp.

  Para particionar de acordo com a data, clique na lista drop-down Coluna da Partição e selecione a coluna DATE ou TIMESTAMP que deseja usar para o particionamento.

• Tipo de Validação: A validação examina os arquivos de origem, as informações de particionamento opcionais e as linhas do relatório que não correspondem às opções de formato especificadas. Selecione Nenhum para nenhuma validação; selecione Amostra para executar a validação com base em uma amostra dos dados; ou selecione Completo para executar a validação com base em todos os dados.

• Usar Curinga: Esta caixa de seleção permite o uso de caracteres curinga na condição de pesquisa para recuperar um grupo específico de arquivos que corresponde aos critérios do filtro.

  Você pode usar um caractere curinga, como um asterisco (*), que pesquisa, filtra e especifica grupos de arquivos que detectam e adicionam novos arquivos à tabela externa.

  Por exemplo, se você informar file*, file01, file02, file03 etc. serão considerados correspondentes à palavra-chave. O asterisco (*) corresponde a zero ou mais caracteres das possibilidades, à palavra-chave.

  Observação
  
  O suporte a curingas é incompatível com o particionamento. A validação do arquivo de origem falhará se você usar curingas com dados particionados.

Guia Configurações - Seção Propriedades

Especifique opções para controlar como os dados de origem são interpretados, visualizados e processados. Essas opções variam, dependendo do tipo de dados de origem.

• Codificação: Selecione um tipo de codificação de caracteres na lista. Esta opção está disponível quando o arquivo vinculado está em formato de texto sem formatação (CSV, TSV ou TXT). O tipo de codificação padrão é UTF-8.

• Anexo de texto: Selecione o caractere para o texto de fechamento: " (caractere de aspas duplas), ' (caractere de aspas simples) ou Nenhum. Essa opção só é visível quando o arquivo selecionado está em formato de texto sem formatação (CSV, TSV ou TXT).

• Delimitador de campo: Selecione o caractere delimitador usado para separar colunas na origem. Por exemplo, se o arquivo de origem usar ponto e vírgula para delimitar as colunas, selecione Ponto e vírgula nesta lista. O padrão é Vírgula. Essa opção só é visível quando o arquivo selecionado está em formato de texto sem formatação (CSV, TSV ou TXT).

• Iniciar o processamento de dados na linha: Especifica o número de linhas a serem ignoradas ao vincular os dados de origem à tabela externa de destino:

  • Se você selecionar a opção Linha do cabeçalho da coluna em Nome da coluna de origem (consulte abaixo) e se você informar um número maior que 0 no campo Iniciar processamento de dados na linha, esse número de linhas após a primeira linha não será vinculado ao destino.

  • Se você desmarcar a opção Linha do cabeçalho da coluna em Nome da coluna de origem e se você informar um número maior que 0 no campo Iniciar processamento de dados na linha, esse número de linhas, incluindo a primeira linha, não será vinculado ao destino.

• Nome da coluna de origem: Marque a caixa de seleção Linha do cabeçalho da coluna para usar os nomes das colunas que formam a tabela de origem na tabela de destino.

  • Se você selecionar essa opção, a primeira linha do arquivo será processada como nomes de coluna. As linhas na seção Mapeamento, abaixo, são preenchidas com esses nomes (e com os tipos de dados existentes, a menos que você os altere).

  • Se você desmarcar essa opção, a primeira linha será processada como dados. Para especificar nomes de coluna manualmente, informe um nome para cada coluna de destino na seção Mapeamento. (Também será necessário inserir tipos de dados.)

• Coluna numérica: Marque a caixa de seleção Converter dados inválidos em nulos para converter um valor de coluna numérica inválido em um valor nulo.

• Newlines incluídas nos valores de dados: Selecione essa opção se houver caracteres de nova linha ou retornar ao início da linha atual sem avançar para baixo nos campos de dados. Selecionar esta opção aumentará o tempo necessário para processar o carregamento. Se você não selecionar essa opção ao carregar os dados, as linhas com novas linhas nos campos serão rejeitadas. Você pode visualizar a linha rejeitada no painel Relatório de Cargo.

Guia Configurações - Seção Mapeamento

As definições na seção Mapeamento controlam como os dados dos arquivos de origem são vinculados às linhas da tabela externa de destino. Para cada linha, os dados da coluna listada em Coluna de origem serão vinculados à coluna listada em Coluna de destino.

• Coluna de origem: Lista as colunas do arquivo de origem.

  Se a opção Linha do cabeçalho da coluna em Propriedades for selecionada, a Coluna de origem mostrará os nomes das colunas no arquivo de origem. Se a opção Linha do cabeçalho da coluna não estiver selecionada, serão usados nomes genéricos como COLUMN_1, COLUMN_2 etc. Este campo é sempre somente leitura.

  Você pode exibir duas colunas de origem FILE$NAME e SYSTIMESTAMP. A coluna FILE$NAME permite localizar o arquivo de origem que contém um registro de dados específico. Por exemplo, você carrega um arquivo de origem que contém uma lista de arquivos. Os nomes de arquivo na lista de arquivos se referem aos nomes de departamento na organização. Por exemplo, um arquivo finance.txt contém dados do departamento Financeiro. No mapeamento, você pode usar tipos de dados de string para extrair o nome do departamento da saída da coluna de nome de arquivo. Você pode usar o nome do departamento extraído para processar dados de forma diferente para cada departamento.

  A coluna SYSTIMESTAMP nos permite exibir o timestamp atual no banco de dados.

  Observação
  
  

  • As colunas de origem FILE$NAME e SYSTIMESTAMP não são incluídas por padrão. Você deve marcar a caixa de seleção Incluir e executar a carga da tabela de destino para exibir essas duas colunas.
  • Quando você está criando um livefeed, as colunas de origem FILE$NAME e SYSTIMESTAMP aparecem na tabela Mapeamento por padrão.

• Coluna de destino: Lista as colunas na tabela de destino.

  • Se a opção Linha do cabeçalho da coluna estiver selecionada, a coluna de destino usará os nomes das colunas no arquivo de origem. Você pode alterar o nome de uma coluna de destino substituindo o nome fornecido por um novo. Certifique-se de que a coluna de destino não esteja vazia. O nome da coluna de destino não deve ser uma duplicata de outra coluna de destino. O nome da coluna de destino não pode ter um nome duplicado como outra coluna de destino. O tamanho da coluna de destino não deve exceder 128 bytes. O limite de 128 bytes é um limite de banco de dados.

  • Se a opção Linha do cabeçalho da coluna não estiver selecionada, nomes genéricos como COLUMN_1, COLUMN_2 etc. serão usados. Você pode alterar o nome de uma coluna de destino substituindo o nome fornecido por um novo.

  Observação
  
  

  Se você estiver vinculando vários arquivos de uma pasta em um único job de link de dados, somente o primeiro arquivo será mostrado na seção Mapeamento. No entanto, enquanto os nomes de coluna e os tipos de dados corresponderem, os dados de todos os arquivos de origem serão vinculados.

• Tipo de Dados: Lista o tipo de dados a ser usado para dados nessa coluna. O conteúdo muda dependendo da opção Obter do cabeçalho do arquivo estar selecionada.

  • Se a opção Linha do cabeçalho da coluna estiver selecionada, o Tipo de dados mostrará os tipos de dados das colunas no arquivo de origem. Se quiser alterar o tipo de dados do destino, clique no nome e selecione um diferente na lista.

  • Se a opção Linha do cabeçalho da coluna não estiver selecionada, o Tipo de dados mostrará todos os tipos de dados disponíveis. Selecione na lista o tipo de dados a ser usado para a coluna de destino.

• Tamanho/Precisão (Opcional): Para colunas em que o Tipo de Dados é NÚMERO, informe o tamanho/precisão para os números na coluna. A precisão é o número de dígitos significativos em um número. A Precisão pode variar de 1 a 38.

  Para colunas em que Tipo de Dados é VARCHAR2, o valor Automático no campo Tamanho/Precisão ativa o recurso Tamanho Automático.

  Com a funcionalidade Largura da coluna de Dimensionamento Automático, você pode dimensionar automaticamente qualquer coluna para se ajustar ao maior valor da coluna. Selecione Automático nos valores drop-down Tamanho/Precisão ou selecione um valor na lista drop-down.

• Dimensionar (Opcional): Para colunas em que o Tipo de Dados é NÚMERO, informe a escala dos números na coluna. A escala é o número de dígitos à direita (positivo) ou à esquerda (negativo) da casa decimal. A balança pode variar de -84 a 127.

• Formato: Se o tipo de dados na coluna Tipo de dados for DATE ou um dos tipos TIMESTAMP, selecione um formato para esse tipo na lista drop-down Formato.

Guia Visualizar

O menu Visualizar Carga na guia Visualizar exibe os dados de origem em formato tabular. A exibição reflete as definições escolhidas na seção Propriedades. O menu Arquivo exibe dados de origem com os nomes de coluna.

Se você arrastou uma pasta que contém vários arquivos para o carrinho de links de dados e clicou em Definições para esse cartão, o painel Visualizar incluirá uma lista drop-down Visualizar Objeto (Arquivo) na parte superior do painel que lista todos os arquivos da pasta. Selecione o arquivo de origem que deseja visualizar nessa lista.

Guia Tabela

A guia Tabela exibe como se espera que a tabela de destino se pareça após os dados terem sido vinculados.

Guia SQL

A guia SQL exibe os comandos SQL que serão executados para concluir este job de link de dados.

Botão Fechar - Salvar e Fechar o Painel

Depois de informar todos os detalhes do job de link de dados, clique em Fechar na parte inferior da página. Isso salva os detalhes que você inseriu e retorna ao painel Vincular Dados do Cloud Storage.