SYS_CONTEXT（SNOWFLAKE$ENVIRONMENT 名前空間）¶

構文¶

SYS_CONTEXT(
  'SNOWFLAKE$ENVIRONMENT' ,
  '<property>'
)

引数¶

'SNOWFLAKE$ENVIRONMENT'

プロパティを取得して、関数が呼び出された環境に関するコンテキスト情報を返すことを指定します。

'property'

取得するプロパティの名前。次のプロパティを指定できます。

プロパティ	説明
CLIENT	関数の呼び出しに使用されたクライアント、ドライバー、またはライブラリの名前とバージョン。 この関数が Snowsight で呼び出された場合、関数はGo Snowflake Driverの名前とバージョンを返します。 この関数が Snowflake CLI で呼び出された場合、関数はPython用Snowflakeコネクタの名前とバージョンを返します。 このプロパティの値は、CURRENT_CLIENT 関数の戻り値と同じです。
ACCOUNT	現在のセッションのアカウントの アカウントロケーター。 このプロパティの値は、CURRENT_ACCOUNT 関数の戻り値と同じです。
REGION	現在のセッションのアカウントの リージョン の名前。 複数の リージョングループ にアカウントがある組織の場合、プロパティの値は region_group.region です。 このプロパティの値は、CURRENT_REGION 関数の戻り値と同じです。

戻り値¶

関数は VARCHAR を返します。

使用上の注意¶

• シェルの二重引用符で囲まれた文字列で関数呼び出しを指定する場合は、$ 文字をバックスラッシュ（\）でエスケープして、$ENVIRONMENT がシェル変数として解釈されないようにします。

  たとえば、Snowflake CLI を使用していて、SQL ステートメントを二重引用符で囲まれたコマンドライン引数として指定する 場合は、次のようになります。

  snow sql --query "SELECT SYS_CONTEXT('SNOWFLAKE\$ENVIRONMENT', 'CLIENT');"
  

  Copy

例¶

次の例は、コマンドの実行に使用されたクライアントの名前とバージョンを返します。

SELECT SYS_CONTEXT('SNOWFLAKE$ENVIRONMENT', 'CLIENT');

次の例は、現在のセッションのアカウントのアカウントロケーターを返します。

SELECT SYS_CONTEXT('SNOWFLAKE$ENVIRONMENT', 'ACCOUNT');

次の例は、現在のセッションのアカウントのリージョンを返します。

SELECT SYS_CONTEXT('SNOWFLAKE$ENVIRONMENT', 'REGION');