Como definir propriedades do ODBC

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 5 min. de leitura

    • As propriedades a seguir personalizam a conectividade e otimizam o comportamento da consulta do ODBC Driver.

    Propriedades do administrador do ODBC

    Essas propriedades são especificadas no Administrador de fonte de dados ODBC para o DSN ou no campo Propriedades personalizadas da caixa de diálogo de login.
    Tabela 1. Propriedades do administrador do ODBC
    Nome da Propriedade Descrição Padrão
    BatchSize Durante a busca de resultados da instância, esse tamanho de lote configura o número de registros a serem buscados 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 este valor deve ser reduzido, você poderá modificá-lo para otimizar o uso da memória versus o desempenho. 2000
    url Este é o endpoint ou URL da instância ServiceNow. Ele deve indicar o URL para a instância ServiceNow à qual você deseja se conectar. https://demo.service-now.com
    HabilitarPassThrough Durante o processamento de funções agregadas, habilitar o modo de passagem permite chamar diretamente o Serviço Web agregado para obter uma resposta otimizada e rápida. Sempre que possível, este modo deve ser deixado habilitado. verdadeiro
    depurar Por padrão, as mensagens de depuração não são produzidas. Defina depurar como verdadeiro ao operar o ODBC Driver 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 como 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. Defina gzip como falso ao usar o parâmetro de depuração para gravar a comunicação de rede no console do ISQL para que os dados não sejam compactados. verdadeiro
    tempo limite Especifica o valor do tempo limite de inatividade do soquete em segundos. 175
    novas tentativas Número de novas tentativas da solicitação com falha em caso de erro de tempo limite de soquete. 0
    Modo O modo de consulta usado para analisar cláusulas "where" complexas. Você pode configurar o modo de consulta do ODBC Driver para usar os operadores AND ou OR.

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

    		 ou
    HabilitarDBSchema O ODBC Driver 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 as aplicações de relatório, como o Microsoft Excel, possam exibir uma lista de tabelas para consulta. Desabilitar esta propriedade pode melhorar o desempenho da primeira consulta enviada de uma aplicação de relatório, especialmente se a instância tiver um grande número de tabelas. verdadeiro
    Cache de esquema estendido O ODBC Driver 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 é útil 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, inclusive quando EnableDBSchema for verdadeiro. falso
    LegacyDurationTimeZone O driver ODBC retorna valores de campo de temporizador e duração no fuso horário UTC por padrão, começando com a versão 1.0.10. Quando esta propriedade é verdadeira, o ODBC Driver retorna valores de campo de temporizador e 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 menu Iniciar Windows em ODBC da ServiceNow > 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 de linha de comando da 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> \Services\ServiceNow_ODBC\Configurações de fonte de dados\ServiceNow\Parâmetros de IP)

    		 Padrão global do 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 do disco. Aumente este valor quando vir erros que o limite de tamanho de arquivo do cache de disco atingiu. 200
    Tempo limite

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

    		 Especifica o valor do tempo limite de inatividade do soquete em segundos. Aumente para um valor maior que glide.soap.request_processing_timeout.odbc quando vir erros de GetKeys com falha (tempo limite do soquete). 175
    ServiceJVMLocation Contém o local do JRE usado pelo ODBC Driver. Não há nenhum 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 do ODBC. Esta propriedade está disponível a partir da versão 1.0.7.1 do ODBC Driver. ${user.home}\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 TRACE, INFO ou ERROR. Esta propriedade está disponível a partir da versão 1.0.8 do ODBC Driver. INFORMAÇÕES

    Propriedades da instância

    Um administrador pode configurar essas propriedades adicionando uma propriedade ou modificando uma existente na instância ServiceNow.
    Tabela 4. Propriedades da instância
    Nome da propriedade Descrição Padrão
    glide.db.max.aggregates O número máximo de linhas retornadas por funções agregadas. 100000
    glide.db.max_view_records O número máximo de linhas retornadas por uma exibição de banco de dados. 10000