Crie uma fonte de dados de tipo de arquivo

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura
  • Crie um Arquivo digite registro de fonte de dados 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 de tipo de arquivo.

    Procedimento

    1. Navegar até Tudo > Conjuntos para 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 usar.
      Nome da tabela de conjunto de importação . ServiceNow AI Platform usa o rótulo inserido 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 "Documento XML Aberto 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ê clicar em Carregar dados ou Carregar 20 registros .
      Tamanho do Lote Especifica o tamanho dos lotes. Aparece somente quando Importação em lote o campo está selecionado.
      . glide.import_set_load_usebatche. glide.import_set_load_batch_sizeas propriedades 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 do campo.
      • Por exemplo, se glide.import_set_load_usebatch. verdadeiro e o. glide.import_set_load_batch_sizea propriedade não está definida, use o tamanho de lote padrão de 1000.
      • Por exemplo, se o glide.import_set_load_usebatcha propriedade não está definida e Importação em lote campo verdadeiro , use Tamanho do lote valor do campo (ou o padrão de 1000 se Tamanho do lote o valor do campo não está definido)
      • Por exemplo, se o glide.import_set_load_usebatchfalso e Importação em lote verdadeiro, não use 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, o. glide.ds.file.http.variable_replacementa propriedade deve ser verdadeira para usar a expansão da propriedade do sistema.

      Por exemplo, você pode especificar Caminho do arquivo valor /countries.csv?key . Quando a conexão é feita, o valor de datasource.apikeya propriedade do sistema é passada como o valor para keyparâmetro.

      Nota:
      Para protocolos HTTP e HTTPS, o caminho do arquivo é codificado automaticamente 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 do script apresenta as opções disponíveis para você. Para obter mais informações, consulte Fontes de dados de 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 de 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. Não selecionado 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 precisarem ser convertidos em colunas adicionais. Se o valor da coluna primária deve ser um fragmento XML ou JSON. Para JSON, observe que selecionar esta 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 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 Arquivo de chave ao usar arquivos de chave público-privados SCP legados.
      Nota:
      • Você não pode autenticar 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 Java padrão para validar o servidor FTPS. Este campo está disponível somente para fontes de dados com um Método de recuperação de arquivo valor de FTPS . Todos os métodos de recuperação de arquivo FTPS são compatíveis, incluindo TLS de autenticação, SSL de autenticação, SSL implícito e TLS implícito.
    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.