Pré-requisitos

A etapa de pré-requisitos é a primeira etapa da fase do assistente do conector. Esta etapa é completamente opcional, mas é recomendada caso o usuário final precise executar alguma configuração adicional fora do aplicativo nativo ou mesmo de todo o contexto do Snowflake. Um exemplo disso poderia ser a configuração de autenticação e autorização no sistema de origem do qual os dados serão ingeridos.

Para configurar os pré-requisitos, eles devem ser inseridos na tabela STATE.PREREQUISITES durante a instalação do conector. A maioria das colunas nessa tabela são autoexplicativas. As colunas URL devem ser usadas para fornecer ao usuário final mais informações sobre as configurações necessárias. Caso haja necessidade de disponibilizar algo mais personalizado nos pré-requisitos, a coluna custom_properties deve ser usada.

A fase de pré-requisitos consiste em 2 etapas:

  1. Marcação de pré-requisitos como concluídos

  2. Conclusão da etapa

Requisitos

Os pré-requisitos exigem que pelo menos os seguintes arquivos sql sejam executados durante a instalação do aplicativo nativo:

  • core.sql

  • configuration/prerequisites.sql

Marcação de pré-requisitos como concluídos

Esta etapa pode ser alcançada de duas maneiras diferentes. Qualquer um dos pré-requisitos pode ser marcado como concluído, um por um, ou todos eles juntos. O resultado final é o mesmo, cada um dos pré-requisitos tem seu valor is_completed definido como true. Esta etapa é realizada pelos seguintes procedimentos:

  • PUBLIC.MARK_ALL_PREREQUISITES_AS_DONE()

  • PUBLIC.UPDATE_PREREQUISITE(ID VARCHAR, IS_COMPLETED BOOLEAN)

Ambos os procedimentos exigem que o conector esteja no status CONFIGURING e o status da configuração não deve ser FINALIZED.

Conclusão da etapa

Para concluir a etapa de pré-requisitos, chame o procedimento PUBLIC.COMPLETE_PREREQUISITES_STEP(). Este procedimento não tem efeito a menos que o conector esteja no status CONFIGURING com status de configuração INSTALLED.

Se for esse o caso, o status será atualizado para o seguinte valor:

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

Este procedimento requer que o conector esteja no status CONFIGURING e o status da configuração não deve ser FINALIZED.

Linguagem: Português