USE <objeto>¶

Especifica a função, warehouse, banco de dados ou esquema a ser usado para a sessão atual:

• A função de uma sessão determina os objetos que podem ser acessados em consultas e outras instruções SQL executadas na sessão.

• Um warehouse é obrigatório para uma sessão executar consultas e outras instruções DML, incluindo dados de carregamento/descarregamento, na sessão.

• Se um banco de dados não for especificado para uma sessão, todos os objetos referenciados em consultas e outras instruções SQL executadas na sessão deverão ser totalmente qualificados com o banco de dados e o esquema, também conhecido como namespace, para o objeto (no formato de db_name.schema_name.object_name). Para obter mais informações sobre nomes de objetos totalmente qualificados, consulte Resolução de nome de objeto.

• Se um banco de dados for especificado para uma sessão, mas o esquema não for especificado para uma sessão, todos os objetos referenciados em consultas e outras instruções SQL executadas na sessão deverão ser qualificados com o esquema do objeto (no formato de schema_name.object_name).

• Se o banco de dados e o esquema forem especificados para uma sessão de usuário, nomes de objeto não qualificados serão permitidos em instruções e consultas SQL.

USE ROLE <name>

USE WAREHOUSE <name>

USE [ DATABASE ] <name>

USE [ SCHEMA ] [<db_name>.]<name>

SELECT CURRENT_ROLE(),
       CURRENT_SECONDARY_ROLES(),
       CURRENT_WAREHOUSE(),
       CURRENT_DATABASE(),
       CURRENT_SCHEMA();

+----------------+--------------------------+---------------------+--------------------+------------------+
| CURRENT_ROLE() | CURRENT_SECONDARY_ROLES  | CURRENT_WAREHOUSE() | CURRENT_DATABASE() | CURRENT_SCHEMA() |
|----------------+--------------------------+---------------------+--------------------+------------------|
| SYSADMIN       | ALL                      | MYWH                | MYTESTDB           | PUBLIC           |
+----------------+--------------------------+---------------------+--------------------+------------------+

USE WAREHOUSE mywarehouse;

USE mytestdb.testschema;