Criar uma fonte de dados de tipo de arquivo

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura
  • Crie um registro de fonte de dados de tipo de arquivo para definir quais dados um conjunto de importação deve importar.

    Antes de Iniciar

    Função necessária: import_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Para obter informações adicionais, confira Fontes de dados do tipo de arquivo.

    Procedimento

    1. Navegar até Todos > Conjuntos de importação do sistema > Administração > Fontes de dados.
    2. Clique em Nova.
    3. Preencha o formulário.
      Campo Descrição
      Nome Um nome exclusivo para esta fonte de dados.
      Rótulo da tabela de conjunto de importação Um rótulo para a tabela de preparação do conjunto de importação a ser usado.
      Nome da tabela de conjunto de importação O Now Platform usa o rótulo que você inseriu para criar um nome de tabela exclusivo. Isso evita a colisão de namespace com uma tabela já existente.
      Tipo Arquivo.
      Formato Somente o formato de arquivo baseado em XML padrão (.xlsx) é compatível, a menos que seja salvo como "Abrir documento XML estrito".
      Compactados Selecionado se o arquivo de importação estiver compactado.
      Usar importação em lote Se selecionado, especifica que os dados de carregamento devem ser colocados em lote quando você clica em Carregar dados ou Testar carga de 20 registros.
      Tamanho do Lote Especifica o tamanho dos lotes. Aparece somente quando o campo Usar importação em lote está selecionado.
      As propriedades glide.import_set_load_usebatch e glide.import_set_load_batch_size afetam esses campos. A ordem de prioridade das propriedades e dos campos é a seguinte: Se a propriedade estiver definida, use o valor da propriedade. Caso contrário, use o valor do campo. Se nenhuma propriedade estiver definida, use o tamanho de lote padrão de 1000.
      • Por exemplo, se glide.import_set_load_usebatch = verdadeiro e glide.import_set_load_batch_size = 200, use 200 como o tamanho do lote, independentemente dos valores de campo.
      • Por exemplo, se glide.import_set_load_usebatch = verdadeiro e a propriedade glide.import_set_load_batch_size não estiver definida, use o tamanho de lote padrão de 1000.
      • Por exemplo, se a propriedade glide.import_set_load_usebatch não estiver definida e o campo Usar importação em lote = verdadeiro, use o valor do campo Tamanho do lote (ou o padrão de 1000 se o valor do campo Tamanho do lote não estiver definido)
      • Por exemplo, se a propriedade glide.import_set_load_usebatch = falso e o campo Usar importação em lote = verdadeiro, não use a importação em lote, pois a propriedade está definida como falsa.
      Método de recuperação de arquivo O método de recuperação deste arquivo.
      Caminho do arquivo O caminho para o arquivo a ser importado.
      Você pode incluir um valor de propriedade do sistema neste campo usando o formato ${system.property.name}. Quando a conexão é feita, a variável é substituída pelo valor da propriedade especificada.
      Nota:
      Para arquivos recuperados usando HTTP ou HTTPS, a propriedade glide.ds.file.http.variable_replacement deve ser verdadeira para usar a expansão da propriedade do sistema.

      Por exemplo, você pode especificar o valor do caminho do arquivo/countries.csv?key=${datasource.apikey}. Quando a conexão é feita, o valor da propriedade do sistema datasource.apikey é passado como o valor do parâmetro key.

      Nota:
      Para os protocolos HTTP e HTTPS, o caminho do arquivo é automaticamente codificado por URL. Não especifique um caminho de arquivo codificado por URL ao usar um desses protocolos.
      Delimitador CSV O caractere delimitador do arquivo CSV.
      Analisando script O script usado para analisar uma única linha de entrada. Conforme você digita o script, o preenchimento automático de script apresenta as opções disponíveis. Para obter mais informações, consulte Fontes de dados do tipo de arquivo.
      Número da folha O número da planilha do Excel para carregar dados.
      Linha de cabeçalho O número da linha do Excel para carregar os rótulos da coluna.
      Caminho para cada linha A expressão do caminho usada para selecionar objetos JSON, que se tornarão linhas na tabela de conjunto de importação. O caminho deve ser // para objetos JSON.
      Descartar Matrizes Selecionado para descartar matrizes JSON como um valor. Desmarcado para serializar matrizes JSON como um valor.
      Expandir elementos secundários do nó Selecionado se os elementos secundários do nó XML ou do objeto JSON devem ser convertidos em colunas adicionais. Não selecionado se o valor da coluna primária for um fragmento XML ou JSON. Para JSON, observe que a seleção desta opção expande somente objetos, não matrizes. Para obter suporte a matrizes aninhadas, consulte Exemplos de importação de arquivo JSON.
      Dados em uma única coluna Selecionado para armazenar dados em uma única coluna.
      Xpath para cada linha Expressão XPath que seleciona os nós que se tornam linhas na tabela de importação. Os secundários dos nós selecionados se tornarão as colunas nas linhas.
      Método de autenticação SCP Opção para autenticar com um nome de usuário e senha ou com uma chave pública.
      Nota:
      Você não pode autenticar em fontes de dados com um par de chaves público-privado. Em vez disso, use uma autenticação de nome de usuário e senha.
      Servidor Nome do servidor do qual as tabelas serão importadas.
      Porta Porta a ser usada para se conectar ao servidor especificado. Este campo aparecerá se você selecionar HTTP ou HTTPS como o método de recuperação de arquivo.
      Nome do usuário Nome de usuário para autenticação no servidor JDBC.
      Senha Senha para autenticação no servidor JDBC.
      Arquivo de chave privada Keyfile ao usar arquivos de chave público-privados SCP legados.
      Nota:
      • Você não pode autenticar em fontes de dados com um par de chaves público-privado. Em vez disso, use autenticação de nome de usuário e senha.
      • Não use esta opção legada. Embora esteja disponível para uso, ele não é compatível.
      Armazenamento de chaves do sistema Selecionado para validar o certificado do servidor FTPS em relação a todos os certificados salvos. Este certificado pode ser qualquer tipo compatível com a instância. Se não for selecionado, a instância usará o certificado padrão Java para validar o servidor FTPS. Este campo está disponível somente para fontes de dados com um valor de Método de recuperação de arquivo de FTPS. Todos os métodos de recuperação de arquivo FTPS são compatíveis, incluindo Auth TLS, Auth SSL, Implicit SSL e Implicit TLS.
    4. Clique em Enviar.

    O que Fazer Depois

    Defina um mapa de transformação para a nova fonte de dados e execute uma importação.