Campos de fonte de dados

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 11 min. de leitura
  • Além dos campos comuns, outros campos aparecem no formulário da fonte de dados, dependendo do valor de Tipo campo.

    Campos de fonte de dados comuns

    Esses campos são comuns a todas as fontes de dados.

    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 O tipo de dados que você está importando:
    • De um controle remoto Arquivo
    • De um JDBC banco de dados
    • Usando LDAP
    • Usando OIDC
    • Usando REST para importar dados por meio do IntegrationHub
    • De um Fluxo de dados ação por meio de IntegrationHub
    • Usando um Personalizado script
    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.
    Aplicação Escopo da aplicação para este registro.

    Campos de fonte de dados de tipo de arquivo

    Esses campos adicionais aparecem no formulário da fonte de dados quando Tipo o valor do campo é Arquivo .

    Campo Descrição
    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.
    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.

    Campos de fonte de dados do tipo JDBC

    Esses campos adicionais aparecem no formulário da fonte de dados quando Tipo o valor do campo é JDBC .

    Campo Descrição
    Usar MID Server MID Server a ser usado para se conectar a esta fonte de dados.
    Formato Um dos seguintes formatos: MySQL, Oracle ou SQLServer.
    Nome da instância Compatível com a conectividade de porta dinâmica com o SQL Server. Para garantir a conectividade, forneça o nome da instância de um SQL Server que receba um novo número de porta dinamicamente após cada reinicialização. Este campo aparece somente quando SQLServer selecionado como um formato de fonte de dados.
    Nome do banco de dados Nome da instância do banco de dados.
    Porta do banco de dados Número da porta do banco de dados. Deixe este campo em branco ao usar a conectividade de porta dinâmica com o SQL Server.
    Usar autenticação integrada Selecionado para permitir que a conexão JDBC use o ID do usuário configurado para o serviço do Windows MID Server para autenticação do SQL Server. Para obter detalhes adicionais, consulte Fonte de dados do tipo JDBC.
    Nome do usuário Nome de usuário para autenticação no servidor JDBC.
    Senha Senha para autenticação no servidor JDBC.
    Servidor Nome do servidor do qual as tabelas serão importadas.
    Consulta Tipo de consulta a ser executada: Todas as linhas da tabela ou SQL específico . Se você optar por executar uma instrução SQL, o campo Instrução SQL será exibido.
    Tempo limite da consulta Número de segundos que o driver JDBC aguardará a conclusão de uma consulta (SELECIONAR). Zero (0) significa que não há tempo limite. Se o tempo limite for excedido, a integração considerará o resultado JDBC inacessível e o colocará em um estado de erro.
    Tempo limite de conexão Número de segundos antes que o pool de cache de conexão do MID Server seja fechado e removido do pool. Zero (0) significa que não há tempo limite.
    Nome da tabela Nome da tabela da qual os dados estão sendo exportados.
    Instrução SQL Instrução SQL para extrair os dados desejados do banco de dados.
    Usar data/hora da última execução Controla a quantidade de dados recuperados de um banco de dados durante uma execução de importação. Se essa opção for desmarcada, todas as linhas da tabela especificada serão sempre importadas. Esta configuração pode ser útil quando se trata de uma importação única ou se todos os dados na tabela de destino forem novos. Se selecionado, dois campos adicionais serão exibidos, permitindo que você selecione um valor de data/hora para limitar os dados importados somente a valores delta.
    Data/hora da última execução O valor de data/hora neste campo é preenchido automaticamente a partir do campo de banco de dados selecionado abaixo e representa o valor mais recente da execução anterior. Este valor atua como um filtro dinâmico para restringir o número de registros recuperados aos registros que foram alterados desde o último tempo de execução da fonte de dados.
    Campo de última execução do banco dados Nome do campo da tabela de origem que será usado como filtro na próxima execução. Este valor pode precisar diferenciar maiúsculas de minúsculas, dependendo do tipo de banco de dados de destino.
    Parâmetros de banco de dados adicionais Parâmetros opcionais a serem adicionados ao final da URL gerada para esta fonte de dados. Lista de parâmetros separada por ponto e vírgula. Pode ser necessário configurar o formulário para exibir este campo.

    Campo de fonte de dados do tipo LDAP

    Este campo adicional aparece no formulário da fonte de dados quando Tipo o valor do campo é LDAP .

    Campo Descrição
    Destino LDAP Destino selecionado na lista de suas definições de OU LDAP.

    Campo de fonte de dados do tipo OIDC

    Este campo adicional aparece no formulário da fonte de dados quando Tipo o valor do campo é OIDC .

    Campo Descrição
    Formato O padrão é -- Nenhum -- e não pode ser alterado.

    REST ( IntegrationHub campos de fonte de dados do tipo )

    Esses campos adicionais aparecem no formulário da fonte de dados quando Tipo o valor do campo é REST (IntegrationHub) .

    Campo Descrição
    Formato Um dos seguintes formatos: Personalizado (analisar por script), JSON ou XML.
    Ação de solicitação Ação de solicitação de fonte de dados que será invocada para obter dados. Você pode escolher somente ações de solicitação publicadas.

    Clique no link na caixa de diálogo abaixo para criar/configurar uma nova ação de solicitação de fonte de dados em IntegrationHub. Depois que a ação de solicitação é publicada em IntegrationHub, você pode escolhê-lo como Ação de solicitação No registro Fonte de dados. Para obter mais informações, consulte Defina propriedades da ação.

    Paginação de suporte Selecionado para habilitar a paginação da ação de solicitação. A paginação ajuda a reduzir a sobrecarga de processamento processando um número especificado de registros por vez, em vez de processar todos os registros de uma só vez.
    Limite Número máximo de registros por página. Por exemplo, para processar 50 registros por vez, insira um Limite de 50.
    Deslocamento O deslocamento inicial usado para paginação. O deslocamento é o número do registro inicial. Por exemplo, para processar 50 registros por vez, começando com o primeiro registro, insira um Limite de 50 e um Deslocamento de 0.
    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.
    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.

    Fluxo de dados ( IntegrationHub campos de fonte de dados do tipo )

    Esses campos adicionais aparecem no formulário da fonte de dados quando Tipo o valor do campo é Fluxo de dados (IntegrationHub) .

    Campo Descrição
    Tipo Fluxo de dados ( IntegrationHub fonte de dados do tipo ).
    Ação de Fluxo de Dados
    • Selecione a ação Fluxo de dadosSelecionado para usar uma ação de Fluxo de dados publicada existente de IntegrationHub.
    • Selecione a ação Fluxo de dados publicado ou Criar nova ação de fluxo de dadosSelecionado por um dos seguintes motivos:
      • Se você selecionar uma ação de Fluxo de dados publicada, clique neste botão para abrir a ação de Fluxo de dados em IntegrationHub.
      • Se você não selecionar uma ação de Fluxo de dados, clique neste botão para criar e publicar uma nova ação de Fluxo de dados no IntegrationHub.
    Nota:
    As ações do Fluxo de Dados exigem uma assinatura de uso de produto.
    Conexão

    Especifique o alias de conexão para a ação Fluxo de dados. Você pode usar o alias primário padrão ou selecionar qualquer um dos aliases secundários. Os aliases secundários disponíveis são listados no menu.

    Este campo só está disponível quando a ação Fluxo de dados está configurada para usar um alias de conexão. Para obter mais informações, consulte Crie um alias de conexão e credencial .

    Dados em uma única coluna Selecionado para armazenar dados em uma única coluna.
    Entradas da ação de Fluxo de Dados Campos adicionais podem aparecer, com base nas entradas definidas em Ação de fluxo de dados .

    Campo de fonte de dados do tipo personalizado (Carregar por script)

    Este campo adicional aparece no formulário da fonte de dados quando Tipo o valor do campo é Personalizado (carregar por script) .

    Campo Descrição
    Carregador de Dados Script usado para carregar dados. Para obter mais informações, consulte Fonte de dados do tipo personalizada (Carregar por script).