了解调用方权限和所有者权限存储过程¶

调用方权限过程的会话变量¶

假设名为 MyProcedure 的存储过程执行读取和设置会话级变量的 SQL 语句。在此示例中，读取和设置命令的详细信息并不重要，因此语句表示为伪代码：

• READ SESSION_VAR1

• SET SESSION_VAR2

存储过程类似于以下伪代码：

CREATE PROCEDURE MyProcedure()
...
$$
   READ SESSION_VAR1;
   SET SESSION_VAR2;
$$
;

Copy

假设您在同一会话中执行以下语句序列：

SET SESSION_VAR1 = 'some interesting value';
CALL MyProcedure();
SELECT *
    FROM table1
    WHERE column1 = $SESSION_VAR2;

Copy

这相当于执行以下序列：

SET SESSION_VAR1 = 'some interesting value';
READ SESSION_VAR1;
SET SESSION_VAR2;
SELECT *
    FROM table1
    WHERE column1 = $SESSION_VAR2;

Copy

换言之：

• 存储过程可以看到在调用过程之前由语句设置的变量。

• 存储过程后面的语句可以看到在过程内部设置的变量。

有关不依赖于伪代码的完整示例，请参阅 在调用方权限和所有者权限存储过程中使用会话变量 （本主题内容）。

在许多存储过程中，您要继承上下文信息，例如当前数据库和当前会话级变量。

但是，在某些情况下，您可能希望存储过程隔离得更明显些。例如，如果存储过程设置了会话级变量，则您可能不希望会话级变量影响存储过程外部的未来语句。

若要更好地将存储过程与会话的其余部分隔离开来，请执行以下操作：

• 避免直接使用会话级变量。相反，请将它们作为显式参数传递。这会强制调用方准确考虑存储过程将使用哪些会话级变量。

• 清理在存储过程内部设置的任何会话级变量（并使用不太可能在其他任何地方使用的名称，以免意外清理在存储过程调用之前便存在的会话变量）。

以下存储过程通过将会话变量的值作为参数接收，而不是直接使用会话变量来使用该值：

SET Variable_1 = 49;
CREATE PROCEDURE sv_proc2(PARAMETER_1 FLOAT)
    RETURNS VARCHAR
    LANGUAGE JAVASCRIPT
    AS
    $$
        var rs = snowflake.execute( {sqlText: "SELECT 2 * " + PARAMETER_1} );
        rs.next();
        var MyString = rs.getColumnValue(1);
        return MyString;
    $$
    ;
  CALL sv_proc2($Variable_1);

Copy

以下存储过程创建具有异常名称的临时会话变量，并在存储过程完成之前清理该变量。当过程调用后的语句尝试使用已清理的会话变量时，该语句将失败：

CREATE PROCEDURE sv_proc1()
    RETURNS VARCHAR
    LANGUAGE JAVASCRIPT
    EXECUTE AS CALLER
    AS
    $$
        var rs = snowflake.execute( {sqlText: "SET SESSION_VAR_ZYXW = 51"} );

        var rs = snowflake.execute( {sqlText: "SELECT 2 * $SESSION_VAR_ZYXW"} );
        rs.next();
        var MyString = rs.getColumnValue(1);

        rs = snowflake.execute( {sqlText: "UNSET SESSION_VAR_ZYXW"} );

        return MyString;
    $$
    ;

CALL sv_proc1();
-- This fails because SESSION_VAR_ZYXW is no longer defined.
SELECT $SESSION_VAR_ZYXW;

Copy

所有者权限过程的会话变量¶

存储过程无权访问在存储过程外部创建的 SQL 变量。此限制可阻止一个用户编写或拥有的存储过程读取另一个用户（存储过程调用方）创建的 SQL 变量。

如果存储过程需要存储在当前会话的 SQL 变量中的值，则应将这些变量中的值作为显式实参传递给存储过程。例如：

SET PROVINCE = 'Manitoba';
CALL MyProcedure($PROVINCE);

了解调用方会话参数对所有者权限过程的影响¶

会话 参数 的值可能会影响命令和函数的行为。例如，输出日期值使用 DATE_OUTPUT_FORMAT 会话参数指定的格式的命令。

在调用方的会话中，调用方可以设置或替换会话参数。在调用方权限存储过程中，会话参数可能会影响在该过程内部执行的任何查询和表达式的执行。例如，TIMESTAMP_OUTPUT_FORMAT 参数会影响子查询（例如 select current_timestamp::string）的输出格式 。

但是，对于所有者权限存储过程，调用方会话的值:emph:`仅`用于以下参数：

• AUTOCOMMIT

• BINARY_INPUT_FORMAT

• BINARY_OUTPUT_FORMAT

• DATE_INPUT_FORMAT

• DATE_OUTPUT_FORMAT

• ENABLE_UNLOAD_PHYSICAL_TYPE_OPTIMIZATION

• ERROR_ON_NONDETERMINISTIC_MERGE

• ERROR_ON_NONDETERMINISTIC_UPDATE

• JDBC_TREAT_DECIMAL_AS_INT

• JSON_INDENT

• LOCK_TIMEOUT

• MAX_CONCURRENCY_LEVEL

• ODBC_USE_CUSTOM_SQL_DATA_TYPES

• PERIODIC_DATA_REKEYING

• QUERY_TAG

• QUERY_WAREHOUSE_NAME

• ROWS_PER_RESULTSET

• STATEMENT_QUEUED_TIMEOUT_IN_SECONDS

• STATEMENT_TIMEOUT_IN_SECONDS

• STRICT_JSON_OUTPUT

• TIMESTAMP_DAY_IS_ALWAYS_24H

• TIMESTAMP_INPUT_FORMAT

• TIMESTAMP_LTZ_OUTPUT_FORMAT

• TIMESTAMP_NTZ_OUTPUT_FORMAT

• TIMESTAMP_OUTPUT_FORMAT

• TIMESTAMP_TYPE_MAPPING

• TIMESTAMP_TZ_OUTPUT_FORMAT

• TIMEZONE

• TIME_INPUT_FORMAT

• TIME_OUTPUT_FORMAT

• TRANSACTION_ABORT_ON_ERROR

• TRANSACTION_DEFAULT_ISOLATION_LEVEL

• TWO_DIGIT_CENTURY_START

• UNSUPPORTED_DDL_ACTION

• USE_CACHED_RESULT

• WEEK_OF_YEAR_POLICY

• WEEK_START

对于 其他 参数（上面未列出）：

• 使用所有者的账户级别参数的值。

• 如果未为所有者的账户设置账户级别参数，则使用账户参数的默认值。

此限制是为了合理避免所有者权限存储过程使用调用方的会话参数时可能发生的潜在问题。例如：

• 如果存储过程的作者（所有者）设置了特定的会话参数，但存储过程的调用方尚未设置该参数，则存储过程在由作者以外的用户调用时可能会失败或表现不同。

• 如果允许存储过程使用调用方设置的任何会话参数的值，则存储过程的所有者可能能够在调用方不知情的情况下确定这些值。

对内置函数的限制¶

如果将存储过程创建为所有者权限存储过程，则调用方（所有者除外）无法调用以下内置函数：

• GET_DDL()

  这样可以阻止存储过程所有者以外的用户查看存储过程的源代码。

• SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE()

• SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE()

ALTER USER¶

以下限制适用于所有者权限存储过程中的 ALTER USER 语句：

• 所有者权限存储过程不能执行 隐式 使用当前用户进行会话的 ALTER USER 语句。（但是，所有者权限存储过程可以执行 显式 识别用户的 ALTER USER 语句，只要该用户不是当前用户即可。）

在执行时监控存储过程¶

所有者权限存储过程的所有者和调用方都不一定具有监控存储过程执行的权限。

具有 WAREHOUSE MONITOR 权限的用户可以监控该存储过程中与各个仓库相关的 SQL 语句的执行。大多数查询和 DML 语句都是与仓库相关的语句。DDL 语句（如 CREATE、ALTER 等）不使用仓库，并且不能作为监控存储过程的一部分进行监视。

SHOW 和 DESCRIBE 命令¶

所有者权限存储过程没有足够的权限来读取调用方以外用户的信息。例如，运行 SHOW USERS LIKE <current_user> 将显示有关当前用户的信息，但除非当前用户是唯一的用户，否则更通用的 SHOW USERS 不能运行。

允许 使用以下 SHOW 命令：

• SHOW DATABASES。

• SHOW SCHEMAS。

• SHOW WAREHOUSES。

对 SQL 语句的限制¶

尽管调用方权限存储过程可以执行调用方具有足够权限在存储过程外部执行的任何 SQL 语句，但所有者权限存储过程只能调用 SQL 语句的子集。

可以 从所有者权限存储过程内部调用以下 SQL 语句：

• SELECT。

• DML。

• DDL。（有关对 ALTER USER 语句的限制，请参阅以上所述。）

• GRANT/REVOKE。

• 变量赋值。

• DESCRIBE 和 SHOW。（请参阅上面记录的限制。）

不能从所有者权限存储过程内部调用其他 SQL 语句。