Visualização NUMTABSREMOTE

A DVSYS.NUMTABSREMOTE exibição mostra o número de tabelas em uma fonte RDBMS remota.

Antes de iniciar

Considere as limitações a seguir:

  • Essa exibição geralmente não chama predicados, mas você pode usar predicados nas colunas CIDFILTER e.
  • Apenas um thread pode chamar a visualização na fonte de dados remota por vez.
  • O tempo limite padrão para chamar essa visualização é de 5 segundos, que pode ser configurado usando a SOURCE_CATALOG_API_CACHED_FOREGROUND_TIMEOUT_MS propriedade.
  • Se a chamada desta visualização expirar, as colunas NUMTABS_FILTEREDNUMTABS_TOTAL ou retornam -1 e a chamada para a fonte remota continuará. Após a conclusão da chamada, o cache é atualizado com o novo valor, que é retornado nas chamadas NUMTABSREMOTE subsequentes.
  • Se as colunas NUMTABS_FILTEREDNUMTABS_TOTAL ou retornarem -2, isso indica que a conexão da fonte de dados está com problemas.
Observação: Na tabela a seguir, uma coluna enviada refere-se a uma coluna cujo valor de predicado é usado em uma consulta remota ou API executada na fonte remota para recuperar o número total de tabelas.
Tabela 1. DVSYS.NUMTABSREMOTE
Coluna Tipo Descrição
CID varchar(2) ID de conexão da origem de dados.
  • Coluna empurrada: um predicado de igualdade nesta coluna corresponderá ao valor CID especificado, portanto, o número de tabelas será calculado apenas para essa fonte.
FILTRO VARCHAR(500) A string composta CSV com o mesmo formato utilizado para as propriedades RELOADTABLES_ALLTABS_<CID> and RELOADTABLES_ALLCOLS_<CID>: '<CATALOG>,<SCHEMAPATTERN>,<TABLENAMEPATTERN>,<TABLETYPES>'.
  • Comportamento padrão: se nenhum predicado de igualdade for especificado nesta coluna, os filtros individuais para cada fonte (conforme especificado na configuração) serão aplicados. Consulte a coluna NUMTABS_FILTERED.
  • Coluna empurrada: um predicado de igualdade nesta coluna filtra os dados comparando o valor especificado com a coluna.
    Por exemplo, a consulta a seguir resolve o número de tabelas na fonte DB20001 com esquema ICP e padrão de TEST_75% tabela (ou seja, todos os nomes de tabelas que começam com TEST_75).
    select * from DVSYS.NUMTABSREMOTE where CID = 'DB20001' and FILTER = 'null,ICP,TEST_75%,null'
TOTAL_NUMTABS BIGINT O número total de tabelas na fonte.
Observação: se você tentar executar essa exibição para várias fontes de catálogo, essa coluna retornará uma saída de -1 como o número total de tabelas, e isso é esperado. Para obter mais informações, consulte : A execução da visualização NUMTABSREMOTE para várias fontes de catálogo retorna -1 como o número total de tabelas.
NUMTABS_FILTRADO BIGINT O número de tabelas na fonte ao aplicar restrições de filtro. Se um predicado de igualdade for especificado em relação à coluna FILTRO, esse valor será usado como filtro. Caso contrário, o valor da propriedade de configuração é RELOADTABLES_ALLTABS_<CID>. Se o valor não estiver configurado, o número será o mesmo que NUMTABS_TOTAL.

Exemplo

Esta chamada de exemplo recupera o número total de tabelas.
SELECT * FROM DVSYS.NUMTABSREMOTE

Saiba Mais

SOURCE_CATALOG_API_CACHED_FOREGROUND_TIMEOUT_MSPara obter mais informações sobre as propriedades, RELOADTABLES_ALLTABS_<CID> e RELOADTABLES_ALLCOLS_<CID> , consulte as propriedades SETCONFIGPROPERTY.