Configuração comum para tutoriais das APIs REST do Snowflake¶
Introdução¶
Este tópico fornece instruções para a configuração comum necessária para todos os tutoriais das APIs REST Snowflake disponíveis nesta documentação.
Visão geral do Snowflake REST APIs¶
Antes de iniciar sua configuração, dê uma olhada no Snowflake REST APIs.
O Snowflake REST APIs oferece suporte aos seguintes recursos através das APIs correspondentes. As APIs oferecem suporte às operações CREATE OR ALTER para recursos aplicáveis.
Trabalho com contas
Trabalho com usuários, funções e privilégios
Gerenciamento de warehouses virtuais
Trabalho com bancos de dados e esquemas
Gerenciamento de tabelas e exibições
Carregamento e descarregamento de dados
Gerenciamento de notebooks
Como trabalhar com Snowpark Container Services
Como usar funções e procedimentos
Gerenciamento de segurança
Gerenciamento de alertas
Aproveitamento de AI/ML
Gerenciamento de fluxos e tarefas
Gerenciamento de integrações
Para obter informações de referência sobre as APIs e seus pontos de extremidade, consulte Referência de Snowflake REST APIs.
Dica
Se você preferir escrever aplicativos Python, é possível usar o Snowflake Python APIs para gerenciar objetos Snowflake. Para obter mais informações, consulte Snowflake Python APIs: Gerenciamento de objetos Snowflake com Python.
Importar as coleções de APIs REST Snowflake¶
Este tutorial explica o processo de importação das coleções APIs REST Snowflake do Postman.
Baixe as coleções de API do repositório Git para uma pasta.
Abra o aplicativo Postman e crie uma conta, se necessário.
No Postman, abra o espaço de trabalho desejado.
Selecione Import.
Selecione folders.
Na caixa de diálogo, selecione a pasta de onde você extraiu a coleção e selecione Open.
Verifique se todos os itens estão selecionados e selecione Import.
Você deverá ver as coleções listadas no painel esquerdo, conforme mostrado:
Especifique o token do portador no Postman¶
As solicitações REST exigem um token JWT no cabeçalho da solicitação para autenticá-la. Se você não tiver um token JWT, consulte Como gerar um token JWT.
No Postman, é possível copiar o token JWT para a propriedade do cabeçalho bearerToken, conforme mostrado.
É possível então definir a chave x-snowflake-authorization-token-type para KEYPAIR_JWT em cada cabeçalho de solicitação, conforme mostrado:
Nota
Conforme mencionado nos pré-requisitos do tutorial, é necessário definir uma AUTHENTICATION POLICY. Se você receber uma mensagem de erro semelhante a { "code": "390202", "message": "Authentication attempt rejected by the current authentication policy." }, é possível executar o seguinte comando SQL para definir uma política:
SHOW AUTHENTICATION POLICIES; alter AUTHENTICATION POLICY <your authentication policy> set AUTHENTICATION_METHODS = ('KEYPAIR', 'PASSWORD', 'OAUTH');
Definição variáveis de ambiente no ambiente Postman¶
É possível definir variáveis de ambiente em seu ambiente Postman. É possível então usar essas variáveis no Postman, no formato {{variable_name}}.
Todas as URLs do ponto de extremidade começam com a baseURL, que identifica sua conta Snowflake. A baseURL tem o formato: <account_locator>.snowflakecomputing.com, onde <account_locator> é o nome da sua conta Snowflake.
Para definir a variável baseURL, bem como quaisquer outras variáveis, no Postman, habilite cada parâmetro e defina seu valor, conforme mostrado:
Para cada valor definido, é necessário selecionar Save para salvar o novo valor.
Qual é o próximo passo?¶
Parabéns! Neste tutorial, você aprendeu os fundamentos para gerenciar recursos de banco de dados, esquema e tabela Snowflake usando o Snowflake REST APIs.
Resumo¶
Ao longo do processo, você concluiu as seguintes etapas:
Importar coleções Snowflake REST APIs.
Especificar um token de portador no Postman.
Definir variáveis de ambiente no ambiente Postman.
Próximo tutorial¶
Agora você pode prosseguir para Tutorial 1: Crie e gerencie bancos de dados, esquemas e tabelas, que mostra como criar e gerenciar bancos de dados, esquemas e tabelas Snowflake.