Definindo propriedades de ODBC

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura

    • As propriedades a seguir personalizam a conectividade e otimizam o comportamento de consulta do driver ODBC.

    Propriedades do administrador ODBC

    Essas propriedades são especificadas no Administrador de fonte de dados ODBC para o DSN ou no Propriedades personalizadas campo da caixa de diálogo de login.
    Tabela 1. Propriedades do administrador ODBC
    Nome da Propriedade Descrição Padrão
    Tamanho em lote Durante a busca de resultados da instância, esse tamanho de lote configura o número de registros a serem obtidos para cada solicitação. Normalmente, o padrão é um número ideal para linhas de tamanho normal. Se ocorrer um erro durante a busca de registros que indique que esse valor deve ser reduzido, você poderá modificá-lo para otimizar o uso da memória versus o desempenho. 2000
    URL . ServiceNow URL ou endpoint da instância. Ele deve indicar o URL para ServiceNow instância à qual você deseja se conectar. https://demo.service-now.com
    EnablePassThrough Habilitar o modo de passagem permite a chamada direta durante o processamento de funções agregadas Agrege o serviço da Web para uma resposta otimizada e rápida. Este modo deve ser mantido habilitado sempre que possível. verdadeiro
    depurar Por padrão, as mensagens de depuração não são produzidas. Definido depuração . verdadeiro Quando você opera o driver ODBC na janela do console ISQL para gravar todo o tráfego de comunicação de rede relacionado a HTTP na janela do console. Ao usar esta opção, defina gzip . falso para que os dados não sejam compactados. Caso contrário, os dados ficarão ilegíveis. falso
    gzip Por padrão, os dados enviados pela rede são compactados. Definido gzip . falso ao usar o. depuração Parâmetro para gravar comunicação de rede no console ISQL para que os dados não sejam compactados. verdadeiro
    timeout Especifica o valor do tempo limite de inatividade do soquete em segundos. 175
    novas tentativas Número de vezes para repetir a solicitação com falha no caso de um erro de tempo limite do soquete. 0
    modo O modo de consulta usado para analisar cláusulas WHERE complexas. Você pode configurar o modo de consulta do driver ODBC para usar os operadores AND ou OR.

    Embora o operador OR forneça a maior compatibilidade com consultas complexas, o operador AND geralmente é mais eficiente e resulta em menos operações de banco de dados.

    		 ou
    EnableDBSchema O driver ODBC emite uma solicitação de esquema de banco de dados para recuperar nomes de tabela da instância. Esta funcionalidade é habilitada por padrão para que aplicações de relatórios, como o Microsoft Excel, possam exibir uma lista de tabelas das quais consultar. Desabilitar esta propriedade pode melhorar o desempenho da primeira consulta enviada de uma aplicação de emissão de relatórios, especialmente se a instância tiver um grande número de tabelas. verdadeiro
    ExtendedSchemaCache O driver ODBC armazena em cache o esquema do banco de dados para cada conexão. Quando uma nova conexão é criada, o driver limpa o cache do banco de dados e consulta o esquema do banco de dados da instância novamente. Este comportamento é benéfico ao se conectar a uma fonte de dados diferente ou ao modificar o esquema da tabela. Ao consultar uma única fonte de dados com um esquema consistente, habilite esta propriedade para evitar o envio de solicitações de esquema desnecessárias, incluindo quando EnableDBSchema . verdadeiro . falso
    LegacyDurationTimeZone Por padrão, o driver ODBC retorna os valores do temporizador e do campo de duração no fuso horário UTC, começando com a versão 1.0.10. Quando esta propriedade é verdadeiro , O driver ODBC retorna os valores do temporizador e do campo de duração usando o valor de exibição, conforme mostrado na IU. Esta propriedade pode ser usada para preservar a compatibilidade com integrações legadas que dependem do valor de exibição. Consulte KB0583982 para obter detalhes sobre esse comportamento. falso

    Se você precisar usar mais de uma dessas propriedades em sua conexão, concatene as configurações com um delimitador de ponto e vírgula (;). Por exemplo, a cadeia de caracteres a seguir define o URL para uma instância específica e muda o tamanho do lote para 200 registros.

    url: https://demo1234.service-now.com;BatchSize=200

    Propriedades do console de gestão ODBC

    Você pode acessar essas propriedades no Console de gestão ODBC disponível no Windows Menu Iniciar em ServiceNow ODBC > Console de gestão.
    Tabela 2. Propriedades do console de gestão ODBC
    Nome da propriedade Descrição Padrão
    ServiceJVMOptions

    (Serviços/Configurações de serviço/Parâmetros de IP)

    		 Propriedades e opção da linha de comando JVM. Por exemplo, para mudar o tamanho máximo do heap Java, modifique o parâmetro -Xmx150m. -Xms64m -Xmx150m
    DataSourceIPProperties

    (Gerenciador do OpenAccess SDK 6,0/<installation location> Serviços/ServiceNow_ODBC/Configurações da fonte de dados/ServiceNow/Parâmetros IP)

    		 Padrão global da URL da instância para todas as conexões ODBC. Para obter mais flexibilidade, você também pode criar novos DSNs com configurações de URL padrão. https://demo.service-now.com
    ServiceSQLDiskCacheMaxSize

    (Serviços/Configurações de serviço/Parâmetros do mecanismo SQL)

    		 Especifica o tamanho máximo dos arquivos de cache de disco. Aumente este valor quando vir O limite de tamanho do arquivo de cache de disco foi atingido erros. 200
    Tempo limite

    (Configurações da fonte de dados/ServiceNow/Parâmetros IP)

    		 Especifica o valor do tempo limite de inatividade do soquete em segundos. Aumente isso para um valor maior que glide.soap.request_processing_timeout.odbc quando você vir GetKeys falhou (tempo limite do soquete) erros. 175
    ServiceJVMLocation Contém o local JRE usado pelo driver ODBC. Não há valor padrão para esta propriedade. Você será solicitado a inserir o local do JRE no momento da instalação.

    Opções de JVM de serviço

    Você pode especificar esses valores no parâmetro ServiceJVMOptions além dos argumentos JVM padrão, como -Xmx.
    Tabela 3. Opções de JVM de serviço
    Opção Descrição Padrão
    DLOG_FILE_NAME O local do arquivo de log ODBC. Esta propriedade está disponível a partir da versão 1.0.7.1 do driver ODBC. AppData Local ServiceNow odbc Logging odbc.log
    -DLOG_LEVEL O nível de registro em log usado ao gravar no arquivo de log ODBC. Você pode especificar o nível de registro em log usando níveis de logback, como RASTREAMENTO, INFORMAÇÕES ou ERRO. Esta propriedade está disponível a partir da versão 1.0.8 do driver ODBC. INFORMAÇÕES

    Propriedades da instância

    Um administrador pode configurar essas propriedades por adição de uma propriedade ou modificação de uma existente no ServiceNow instância.
    Tabela 4. Propriedades da instância
    Nome da propriedade Descrição Padrão
    glide.db.max.agregados O número máximo de linhas retornadas por funções agregadas. 100.000
    glide.db.max_view_records O número máximo de linhas retornadas por uma exibição de banco de dados. 10001