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 ou esquema não for especificado para uma sessão, quaisquer objetos referenciados em consultas e outras instruções SQL executadas na sessão devem ser totalmente qualificados com o banco de dados e esquema, também conhecido como namespace, para o objeto.
Sintaxe¶
USE ROLE <name>
USE WAREHOUSE <name>
USE [ DATABASE ] <name>
USE [ SCHEMA ] [<db_name>.]<name>
Para sintaxes, notas de uso e exemplos específicos, consulte:
Notas de uso geral¶
Para ver a função atual, funções secundárias, banco de dados, esquema e warehouse para a sessão, use as funções de contexto correspondentes. Por exemplo:
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 | +----------------+--------------------------+---------------------+--------------------+------------------+
Para obter mais detalhes, consulte Funções de contexto.
Exemplos¶
Utilizar um warehouse:
USE WAREHOUSE mywarehouse;
Usar um esquema com o nome totalmente qualificado do esquema especificado:
USE mytestdb.testschema;
Usar um esquema sem o nome totalmente qualificado do esquema especificado (exige que o banco de dados do esquema já esteja em uso para a sessão):
USE testschema;