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:

  1. chave STRING

  2. valor VARIANT

  3. atualizado_em TIMESTAMP_NTZ

O seguinte status é definido como valor padrão durante a instalação:

{
    "status": "CONFIGURING",
    "configurationStatus": "INSTALLED"
}
Copy

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 publicamente

  • VIEWER - tem acesso a todos os procedimentos e exibições somente leitura

  • DATA_READER - não tem acesso a nada por padrão. Deve ser usado para acessar somente o banco de dados do coletor