参数

适用对象: Databricks SQL 选中标记为“是” Databricks Runtime 11.3 LTS 及更高版本 选中标记为“是” 仅 Unity Catalogcheck marked yes

重要

此功能目前以公共预览版提供。

INFORMATION_SCHEMA.PARAMETERS 会列出目录中的例程参数。

返回的行仅限于用户有权与之交互的例程。

定义

PARAMETERS 关系包含以下列:

名称 数据类型 可为空 标准 描述
SPECIFIC_CATALOG STRING 否 是 包含例程的目录。
SPECIFIC_SCHEMA STRING 否 是 包含例程的数据库(架构)。
SPECIFIC_NAME STRING 否 是 例程架构唯一(指定)名称。
ORDINAL_POSITION INTEGER 否 是 参数在例程参数列表中的位置(底数为 1)。
PARAMETER_MODE STRING 否 是 'IN', 'INOUT' 或 'OUT'。
IS_RESULT STRING 否 是 始终为 'NO'。 保留供将来使用。
AS_LOCATOR STRING 否 是 始终为 'NO'。 保留供将来使用。
PARAMETER_NAME STRING 是 是 参数的名称,如果未命名,则为 NULL。
DATA_TYPE STRING 否 是 参数数据类型名称。
FULL_DATA_TYPE STRING 否 否 参数数据类型定义,例如 'DECIMAL(10, 4)'。
CHARACTER_MAXIMUM_LENGTH INTEGER 是 是 始终为 NULL,保留以供将来使用。
CHARACTER_OCTET_LENGTH STRING 是 是 始终为 NULL,保留以供将来使用。
NUMERIC_PRECISION INTEGER 是 是 对于底数为 2 的整数类型、FLOAT 和 DOUBLE,支持的位数。 对于位数 DECIMAL,否则为 NULL。
NUMERIC_PRECISION_RADIX INTEGER 是 是 对于 DECIMAL,为 10;对于所有其他数字类型,为 2;否则为 NULL。
NUMERIC_SCALE INTEGER 是 是 对于整数类型 0,小数点右侧的位数 DECIMAL,否则为 NULL。
DATETIME_PRECISION INTEGER 是 是 对于 DATE,为 0;对于 TIMESTAMP 和 INTERVAL … SECOND,为 3;对于其他任何 INTERVAL,为 0;否则为 NULL。
INTERVAL_TYPE STRING 是 是 对于间隔的单位部分 INTERVAL(例如 'YEAR TO MONTH'),否则为 NULL。
INTERVAL_PRECISION INTERAL 是 是 始终为 NULL,保留以供将来使用。
MAXIMUM_CARDINALITY INTEGER 是 是 始终为 NULL,保留以供将来使用。
PARAMETER_DEFAULT STRING 是 是 始终为 NULL,保留以供将来使用。
COMMENT STRING 是 否 描述参数的可选注释。

约束

以下约束适用于 PARAMETERS 关系:

类 名称 列列表 描述
主密钥 PARAMETERS_PK SPECIFIC_CATALOG,SPECIFIC_SCHEMA,SPECIFIC_NAME,ORDINAL_POSITION 唯一标识参数。
外键 PARAMETERS_ROUTINES_FK SPECIFIC_CATALOG,SPECIFIC_SCHEMA,SPECIFIC_NAME 引用 ROUTINES_PK

示例

> SELECT parameter_name, data_type
    FROM information_schema.parameters
    WHERE specific_schema = 'default'
      AND specific_name = 'foo'
    ORDER BY ordinal_position;