Referência de SQL essencial¶
Arquivo: core.sql
Objetos e procedimentos de banco de dados¶
STATE SCHEMA¶
Um esquema não versionado contendo o estado interno do conector. Este esquema é persistido entre diferentes versões do aplicativo.
STATE.APP_STATE¶
Tabela para armazenar o status atual do conector. Esta tabela só é acessível internamente. A tabela contém as seguintes colunas:
chave STRING
valor VARIANT
atualizado_em TIMESTAMP_NTZ
O seguinte status é definido como valor padrão durante a instalação:
{
"status": "CONFIGURING",
"configurationStatus": "INSTALLED"
}
Para recuperar o status, use o procedimento GET_CONNECTOR_STATUS
abaixo.
PUBLIC.GET_CONNECTOR_STATUS()¶
Este procedimento recupera o status atual da tabela APP_STATE
. Uma exceção será lançada quando o status não existir na tabela.
PUBLIC.RECOVER_CONNECTOR_STATE(NEW_CONNECTOR_STATUS STRING)¶
Esse procedimento permite que o usuário force uma alteração do status do conector. Deve ser usado apenas como último recurso, quando todos os outros meios de fixação do conector falharam e o conector está «preso» em um estado imutável.
O procedimento só pode ser usado por um usuário com a função ADMIN
para forçar a alteração do status do conector dos status STARTING
, PAUSING
ou ERROR
para STARTED
ou PAUSED
.
Funções¶
O arquivo core.sql
introduz as seguintes funções no aplicativo:
ADMIN
- tem acesso a todos os procedimentos e exibições expostos publicamenteVIEWER
- tem acesso a todos os procedimentos e exibições somente leituraDATA_READER
- não tem acesso a nada por padrão. Deve ser usado para acessar somente o banco de dados do coletor