Account & session DDL

The following DDL commands are used to view and manage account-level and session operations, including:

  • Viewing parameters at multiple levels in the system (account, session, object).
  • Setting parameters at the account-level and within a session.
  • Using a role, warehouse, database, or schema within a session.
  • Using multi-statement transactions within a session.
  • Setting and using SQL variables within a session.

Account parameters & functions

ALTER ACCOUNTFor setting parameters at the account-level; can only be performed by users with the ACCOUNTADMIN role.
SHOW FUNCTIONSDisplays system-defined functions, as well as any user-defined functions.
SHOW PARAMETERSFor viewing parameter settings for the account.

Accounts

CREATE ACCOUNTUsed to create accounts in an organization.
DROP ACCOUNT
SHOW ACCOUNTSLists the accounts in an organization.
SHOW ORGANIZATION ACCOUNTSUse SHOW ACCOUNTS instead.
SHOW REGIONS
UNDROP ACCOUNT

Managed accounts

CREATE MANAGED ACCOUNTCurrently used to create reader accounts for providers who wish to share data with non-Snowflake customers.
DROP MANAGED ACCOUNT
SHOW MANAGED ACCOUNTS

Replication and failover/failback

Session parameters

ALTER SESSIONFor setting parameters within a session; can be performed by any user.
SHOW PARAMETERSFor viewing parameter settings for the session (or account); can also be used to view parameter settings for a specified object.

Session context

USE ROLESpecifies the primary role to use in the session.
USE SECONDARY ROLESSpecifies the secondary roles to use in the session.
USE WAREHOUSESpecifies the virtual warehouse to use in the session.
USE DATABASESpecifies the database to use in the session.
USE SCHEMASpecifies the schema to use in the session (specified schema must be in the current database for the session).
See also:

Context functions

Queries

DESCRIBE RESULTDescribes the columns in the results from a specified query (must have been executed within the last 24 hours).
SHOW LOCKSFor use with multi-statement transactions.

Session transactions

BEGINFor use with multi-statement transactions.
COMMITFor use with multi-statement transactions.
DESCRIBE TRANSACTIONDescribes the state of the transaction (e.g. committed, rolled back, running), etc.
ROLLBACKFor use with multi-statement transactions.
SHOW TRANSACTIONSLists all running transactions.

SQL variables

SETFor defining SQL variables in the session.
SHOW VARIABLESFor showing SQL variables in the session.
UNSETFor dropping SQL variables in the session.