--- sourceDocument: Referência de API do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Referência de API do Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Como definir propriedades ODBC # Como definir propriedades ODBC {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura As propriedades a seguir personalizam a conectividade e otimizam o comportamento de consulta do ODBC Driver. ## Propriedades do administrador ODBC Essas propriedades são especificadas no ODBC Data Source Administrator para o DSN ou no campo Propriedades personalizadas da caixa de diálogo de login.{#r_SettingODBCProperties__table_vxg_tmt_jp__entry__3} | Nome da Propriedade | Descrição | Padrão | |-|-|-| | Tamanho do lote | Durante a busca de resultados da instância, este 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 Serviço Web Agregado para 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 a depuração como verdadeira 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 serã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 vezes para tentar novamente a 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. 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 | | HabilitarDBSchema | O ODBC Driver emite uma solicitação de esquema de banco de dados para recuperar nomes de tabelas da instância. Esta funcionalidade é habilitada por padrão para que aplicações de emissão de relatórios, 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 emissão de relatórios, 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 ODBC Driver 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](https://support.servicenow.com/kb_view.do?sysparm_article=KB0583982) para obter detalhes sobre esse comportamento. | falso | [Tabela 1. Propriedades do administrador ODBC] {#r_SettingODBCProperties__table_vxg_tmt_jp} 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 {#r_SettingODBCProperties__ODBC_mgmt_console_properties} Você pode acessar essas propriedades no Console de gestão ODBC disponível no menu Iniciar Windows em ODBC da ServiceNowConsole de gestão.{#r_SettingODBCProperties__table_mdz_znt_jp__entry__3} | Nome da propriedade | Descrição | Padrão | |-|-|-| | ServiceJVMOptions (Serviços\\Configurações de serviço\\Parâmetros IP) | Propriedades e opção de linha de comando da JVM. Por exemplo, para alterar o tamanho máximo do heap Java, modifique o parâmetro -Xmx150m. | -Xms64m -Xmx150m | | DataSourceIPProperties (Gerenciador do OpenAccess SDK 6.0\\\ \\Serviços\\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 de disco. Aumente este valor quando vir erros `de limite de tamanho de arquivo de cache de disco atingido`. | 200 | | Tempo limite (Configurações da 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 `fail (tempo limite do soquete)`. | 175 | | ServiceJVMLocation | Contém o local do JRE usado pelo ODBC Driver. | Não há valor padrão para esta propriedade. Você será solicitado a inserir o local do JRE no momento da instalação. | [Tabela 2. Propriedades do console de gestão ODBC] {#r_SettingODBCProperties__table_mdz_znt_jp} ## 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.{#r_SettingODBCProperties__table_zcl_14z_1r__entry__3} | 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 | [Tabela 3. Opções de JVM de serviço] {#r_SettingODBCProperties__table_zcl_14z_1r} ## Propriedades da instância Um administrador pode configurar essas propriedades adicionando uma propriedade ou modificando uma existente na instância ServiceNow.{#r_SettingODBCProperties__table_hgq_m4t_jp__entry__3} | Nome da propriedade | Descrição | Padrão | |-|-|-| | glide.db.max.aggregates | 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 | [Tabela 4. Propriedades da instância] {#r_SettingODBCProperties__table_hgq_m4t_jp}