SHOW OPENFLOW DATA PLANE INTEGRATIONS¶
列表 OPENFLOW DATA PLANE INTEGRATIONS。仅显示 OPENFLOW DATA PLANE INTEGRATIONS,其中执行命令的用户对 OPENFLOW DATA PLANE INTEGRATION 具有 USAGE、MODIFY 或 OWNERSHIP。
语法¶
SHOW OPENFLOW DATA PLANE INTEGRATIONS [ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
可选参数¶
LIKE 'pattern'(可选)按对象名称筛选命令输出。筛选器使用 不区分大小写 的模式匹配,并支持 SQL 通配符(
%和_)。例如,以下模式返回 相同的 结果:
... LIKE '%testing%' ...... LIKE '%TESTING%' .... 默认:无值(不对输出应用筛选)。
STARTS WITH 'name_string'(可选)根据对象名称开头显示的字符筛选命令输出。该字符串必须放在单引号内并且 区分大小写。
例如,以下字符串会返回 不同的 结果:
... STARTS WITH 'B' ...... STARTS WITH 'b' .... 默认:无值(不对输出应用筛选)
LIMIT rows [ FROM 'name_string' ](可选)限制返回的最大行数,同时还对结果启用“分页”功能。返回的实际行数可能小于指定的限制。例如,现有对象的数量小于指定的限制。
可选的
FROM 'name_string'分子句实际上会充当结果的“游标”。这样就可以提取对象名称与指定字符串匹配的第一行之后的指定行数:该字符串必须放在单引号内并且 区分大小写。
该字符串不必包含完整的对象名称;支持部分名称。
默认:无值(不对输出应用限制)
备注
对于支持
FROM 'name_string'和STARTS WITH 'name_string'的 SHOW 子句,您可以将这两个子句组合在同一语句中。但是,两个条件都必须满足,否则它们相互抵消,不返回任何结果。此外,对象按名称的字典顺序返回,因此
FROM 'name_string'仅返回字典值高于STARTS WITH 'name_string'所返回行的行。例如:
... STARTS WITH 'A' LIMIT ... FROM 'B'不会返回任何结果。... STARTS WITH 'B' LIMIT ... FROM 'A'不会返回任何结果。... STARTS WITH 'A' LIMIT ... FROM 'AB'将返回结果(如果有任何行与输入字符串匹配)。
使用说明¶
Openflow 数据平面集成不能直接创建,而是在创建部署时创建。
要 SHOW OPENFLOW DATA PLANE INTEGRATION,您必须使用对 Openflow 数据平面集成具有 USAGE、MODIFY 或 OWNERSHIP 权限的角色。
LIMIT rows的值不能超过10000。如果省略LIMIT rows,若结果集大于 1 万行,则该命令将导致错误。要查看存在超过 1 万条记录的结果,请在 Snowflake Information Schema 中包含
LIMIT rows或查询相应的视图。
要对该命令的输出进行后处理,可以使用 管道运算符 (
->>) 或 RESULT_SCAN 函数。这两种构造都将输出视为可以查询的结果集。此命令的输出列名称以小写形式生成。如果您通过管道运算符或 RESULT_SCAN 函数使用此命令的结果集,请在查询中对列名使用 加双引号的标识符,以确保它们与已扫描输出中的列名相匹配。例如,如果输出列的名称为
type,则为标识符指定"type"。
输出¶
命令输出在以下列中提供 Openflow 数据平面集成属性和元数据。
列 |
描述 |
|
Openflow 数据平面集成的名称 |
|
始终为 |
|
始终为 |
|
如果已启用,则为 True,否则为 False |
|
关联的注释。 |
|
数据平面集成的创建日期和时间 |
|
数据平面集成的内部标识符 |
示例¶
显示名称以 MYDATAPLANE 开头的所有数据平面集成:
SHOW OPENFLOW DATA PLANE INTEGRATIONS LIKE 'MYDATAPLANE%'