Etapa 1. Entrar no SnowSQL¶
Depois que o SnowSQL estiver instalado (consulte Pré-requisitos para obter detalhes), inicie o SnowSQL para conectar-se ao Snowflake:
Abra uma janela de terminal.
Iniciar o SnowSQL:
$ snowsql -a <account_identifier> -u <user_name>
Onde:
<account_identifier>
Identificador único de sua conta Snowflake.
O formato preferido do identificador de conta é o seguinte:
organization_name-account_name
Nomes de sua conta e organização no Snowflake. Para obter mais detalhes, consulte Formato 1 (preferido): Nome da conta em sua organização.
Alternativamente, especifique seu localizador de contas, juntamente com a região e a plataforma de nuvem no formato
<locator>.<region>.<cloudprovider>
onde a conta é hospedada, se necessário. Para obter mais detalhes, consulte Formato 2 (legado): Localizador de conta em uma região.
<user_name>
é o nome de login de usuário do Snowflake.
Nota
Se sua conta tiver um provedor de identidade (IdP) definido para sua conta, você pode usar um navegador web para autenticar em vez de uma senha, como demonstra o exemplo a seguir.
$ snowsql -a <account_identifier> -u <user_name> --authenticator externalbrowser
Para obter mais informações, consulte o Uso de um navegador da web para autenticação federada/SSO.
Quando solicitado pelo SnowSQL, digite a senha do usuário Snowflake.
Se você entrar com sucesso, o SnowSQL exibirá um prompt de comando que inclui seu warehouse atual, banco de dados e esquema.
Nota
Se você tiver o acesso à conta bloqueado e não conseguir obter o identificador da conta, você poderá encontrá-lo no e-mail de boas-vindas que Snowflake enviou quando você se inscreveu para a conta de teste, ou você pode contatar seu ORGADMIN para obter os detalhes da conta. Você também pode encontrar os valores para locator
, cloud
e region
no e-mail de boas-vindas.
Se seu usuário Snowflake não tiver um warehouse, banco de dados e esquema padrão, ou se você não tiver configurado o SnowSQL para especificar um warehouse, banco de dados e esquema padrão, o prompt exibe no warehouse
, no database
e no schema
. Por exemplo:
user-name#(no warehouse)@(no database).(no schema)>
Este prompt indica que não há nenhum warehouse, banco de dados e esquema selecionado para a sessão atual. Você cria estes objetos na próxima etapa. Ao seguir os próximos passos neste tutorial para criar estes objetos, o prompt é atualizado automaticamente para incluir os nomes destes objetos.
Para obter mais detalhes, consulte Conexão por meio do SnowSQL.
Próximo: Etapa 2. Criar objetos Snowflake