Como usar o sfsql — Obsoleto¶

Navegação e edição na linha de comando¶

O sfsql oferece suporte a todas as funções padrão de edição de linha de comando, inclusive:

• Teclas para cima e para baixo para acessar o histórico de comandos.

• Combinações de teclas Control e Meta (por exemplo, [CTRL]-a, [CTRL]-e) para navegação e edição de texto na linha de comando.

Definição de parâmetros¶

O HenPlus oferece propriedades que controlam o comportamento da sessão. Entretanto, você não deve definir essas propriedades no sfsql. Em vez disso, use os parâmetros de sessão fornecidos pelo Snowflake.

Além disso, o HenPlus fornece as seguintes propriedades globais que podem ser definidas em todas as sessões (as configurações de propriedades são salvas quando você sai da sessão). Você pode usar essas propriedades globais para controlar a formatação e a aparência dos resultados da sua instrução SQL:

• Para ver a lista de parâmetros globais e seus valores atuais, digite set-property na linha de comando:

  Propriedade	Valor inicial	Descrição
  column-delimiter	|	Especifica o(s) caractere(s) utilizado(s) para separar/formatar colunas na exibição.
  comments-remove	desativado (ou falso)	Não utilizada atualmente.
  echo-commands	desativado (ou falso)	Especifica se deve exibir uma instrução antes de executá-la.
  sql-result-limite	1000000000	Especifica o número máximo de linhas retornadas nos resultados da instrução.
  sql-result-showfooter	ativado (ou verdadeiro)	Especifica se uma linha de rodapé deve ser incluída nos resultados.
  sql-result-showheader	ativado (ou verdadeiro)	Especifica se uma linha de cabeçalho, incluindo os cabeçalhos das colunas, deve ser incluída nos resultados.

• Para definir um parâmetro global, digite set-property seguido pelo nome e o valor do parâmetro.

  Por exemplo, para desativar os cabeçalhos e rodapés nos resultados:

  user1@xy12345.snowflakecomputing.com> set-property sql-result-showfooter false
  user1@xy12345.snowflakecomputing.com> set-property sql-result-showheader false
  

  Copy

  Note que você não precisa digitar nenhum caractere de fechamento, por exemplo, ponto e vírgula (;), para definir as propriedades globais.

Execução de arquivos de script e instruções SQL¶

Para executar uma consulta ou instrução SQL:

• Digite um ponto e vírgula (;) imediatamente após o final da instrução.

• Se você inserir uma nova linha após a instrução, você deve digitar dois ponto e vírgula (;;) para executar a instrução.

• Em uma nova linha, você também pode digitar uma barra (/), que é o comando para terminar uma instrução.

Por exemplo, qualquer uma das sintaxes pode ser usada para executar a seguinte consulta:

user1@xy12345.snowflakecomputing.com> select * from test1;


user1@xy12345.snowflakecomputing.com> select * from test1
                                      ;;

user1@xy12345.snowflakecomputing.com> select * from test1
                                      /

Copy

Para executar um arquivo de script SQL, use @ ou @@, seguido pelo caminho do diretório e nome completo do arquivo (incluindo a extensão do arquivo, se houver).

Por exemplo, para executar um arquivo chamado query.sql, localizado no diretório /Users/user1/scripts:

user1@xy12345.snowflakecomputing.com> @/Users/user1/scripts/query.sql

Copy

Cancelamento de consultas em andamento¶

Para cancelar uma consulta que ainda não foi concluída, use o atalho [CTRL]-c.

Gravação dos resultados em um arquivo¶

Para gravar os resultados de uma consulta ou comando SQL em um arquivo, digite spool seguido do caminho do diretório e do nome do arquivo onde os resultados serão gravados.

Para encerrar a gravação dos resultados, digite spool off.

Acesso à ajuda da linha de comando do Snowflake¶

O Snowflake oferece tópicos de ajuda na linha de comando. Para ter acesso à ajuda, use a seguinte sintaxe:

info [ <topic> | <subtopic> ]

• Se nenhum valor for especificado, todos os tópicos de nível superior da ajuda serão exibidos.

• Se um tópico for especificado, todos os subtópicos desse tópico serão exibidos.

• Se um subtópico for especificado, o conteúdo do subtópico será exibido.

Por exemplo:

info;

info warehouses;

info alter_warehouse;

Copy

Comandos do HenPlus sem suporte¶

O HenPlus oferece comandos nativos para executar tarefas como descrição de objetos e importação/exportação de dados do sistema. Você não deve usar esses comandos no sfsql. Em vez disso, use os comandos SQL do Snowflake: