--- 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 --- # Comportamento do ODBC # Comportamento do ODBC {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura Depois de testar o ODBC Driver, você pode usá-lo para consultar o banco de dados da instância a partir de uma variedade de aplicações cliente. ## Funções agregadas de ODBC {#r_ODBCBehavior__section_k4m_fbc_vbb} O ODBC Driver tenta baixar dados e aplicar funções agregadas localmente. O ODBC Driver é compatível com as seguintes funções agregadas. * CONTAGEM * SOMA * MÍN * MÁX * MÉDIA {#r_ODBCBehavior__ul_p2l_3bc_vbb} Ative o plug-in Aggregate web service para melhorar o desempenho de consultas agregadas por meio do ODBC Driver. ## Valores de data e hora do ODBC {#r_ODBCBehavior__section_jjq_4bc_vbb} A instância e a máquina na qual o ODBC Driver está instalado podem usar dois fusos horários diferentes. Os valores de data e hora retornados pelo ODBC Driver estão no fuso horário local da aplicação que usa o driver, não no fuso horário da instância da ServiceNow. Certifique-se de consultar em fusos horários precisos para a instância e a máquina que hospeda o ODBC Driver. O GlideRecord executa a filtragem com base no fuso horário da instância e o cliente ODBC é filtrado com base no fuso horário do Windows. Por exemplo, uma instância está no Horário Padrão Central (CST) e o ODBC Driver está instalado em uma máquina que está no Horário Padrão do Pacífico (PST). Um incidente é criado na instância em 2014-05-20 10:00:00, e a hora em que o incidente foi criado é exibida na IU como 10:00:00 para usuários em ambos os fusos horários. No entanto, para consultar com êxito este incidente por data e hora de criação, um usuário na máquina no PST deve consultar 2014-05-20 08:00:00 em vez de 2014-05-20 10:00:00. Os campos de duração e tipo de temporizador são retornados usando o fuso horário UTC, começando com o ODBC versão 1.0.10. Consulte [KB0583982](https://support.servicenow.com/kb_view.do?sysparm_article=KB0583982) para obter detalhes sobre essa mudança. ## Valores de exibição do ODBC {#r_ODBCBehavior__section_mks_gcc_vbb} Alguns exemplos de como usar e trabalhar com valores de exibição ODBC são mostrados abaixo. * Exibir valores nas colunas Opção e Referência : Ao consultar uma coluna do tipo Opção, Referência, Duraçãoou Temporizador, uma coluna adicional com o prefixo `dv_` está disponível e contém o valor de exibição. Por exemplo, você pode selecionar dv_caller_id para retornar o valor de exibição sys_user.name do campo de referência de um registro de incidente sem fazer outra solicitação à tabela sys_user. Figura 1. Retornar o valor de exibição * Exibir valores nas condições do filtro:Os valores de exibição também podem ser usados em uma condição de filtro. O ODBC Driver otimiza a condição de consulta e processa o filtro no servidor, por exemplo, consultando o valor de exibição de sys_user para o campo caller_id de um incidente usando o nome do campo dv_caller_id. Figura 2. Exibir valores nas condições de filtro * Exibir valores em consultas agregadas:As consultas agregadas também podem aproveitar as vantagens dos valores de exibição se você especificá-los na cláusula group by ou Where, por exemplo, agrupar no campo caller_id de um incidente, bem como especificar um filtro para ele. A consulta é otimizada passando para o servidor. Figura 3. Exibir valores em consultas agregadas {#r_ODBCBehavior__ul_lzl_mcc_vbb} ## Consultando nomes de tabela e coluna {#r_ODBCBehavior__section_fw5_xfc_vbb} Você pode obter uma lista de tabelas e colunas acessíveis com base nas ACLs de leitura do usuário de consulta. * A consulta a seguir retorna os nomes de todas as tabelas para as quais o usuário da consulta tem acesso de leitura:`selecione * de oa_tables;` * Depois de saber o nome da tabela que deseja consultar, você pode consultar os nomes de todas as colunas para as quais o usuário tem acesso de leitura. O usuário de consulta deve ter acesso de leitura para a tabela e as colunas.`selecione * de oa_columns em que table_name='table_name';` {#r_ODBCBehavior__ul_xqb_dgc_vbb} Nota: As tabelas oa_tables e oa_columns são tabelas ODBC internas. Essas tabelas podem ser acessadas somente por meio do ODBC Driver. ## Roteamento de chamadas ODBC para réplica de leitura {#r_ODBCBehavior__section_uhx_2hy_sxb} O roteamento de consulta é feito para aliviar a carga do banco de dados primário para consultas SELECT que usam vários ciclos de CPU do banco de dados no banco de dados primário. Para obter mais informações, consulte [Introdução aos bancos de dados de réplica de leitura da ServiceNow](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0824441). Para roteamento de chamadas ODBC para Réplica de leitura, vá para TodosBanco de dados secundárioCategorias de BD secundário e defina odbc como verdadeiro. * **[Como aumentar o tamanho do campo em consultas SQL](https://servicenow-prod.fluidtopics.net/zL6oZXtcNguQzDeVxOvasg)** O ODBC Driver limita o tamanho do campo em consultas SQL ao tamanho máximo definido pela entrada de dicionário ServiceNow. Você pode aumentar o tamanho máximo do campo para evitar o truncamento de dados.