更改开始

BIND SERVICE 子命令(数据链路层)

BIND SERVICE (DSN) 子命令用于构建一个代表 Db2 REST 服务的应用程序包。Db2 在目录表中记录服务描述,并将准备好的包保存在目录中。

环境 BIND SERVICE

您可以在前台或后台运行的 TSO 下的 DSN 会话中发出绑定服务。

数据共享范围 :集团

授权 BIND SERVICE

包所有者必须拥有所需的授权,例如SYSADM或DATAACCESS权限,才能执行包中嵌入的SQL语句并构建包。

如果绑定服务是在使用角色作为对象所有者子句定义的可信环境中发出的,则包所有者必须是一个具有角色所有权的角色,才能执行该命令。 如果指定了命令的 OWNER 选项,则所有者将被赋予一个角色。 如果未指定所有者选项,则装订者的角色将成为所有者。 如果未使用 ROLE AS OBJECT OWNER 子句指定可信上下文,则适用当前 BIND 所有权规则。

对于VALIDATE(BIND), Db2 会在绑定时验证授权。 对于 VALIDATE(RUN), Db2 会在绑定时验证授权,但如果授权检查失败, Db2 会在运行时重新检查。 下表总结了运行BIND SERVICE所需的授权,具体取决于您指定的绑定选项,以及ACTION(ADD)选项中安装面板上BIND NEW PACKAGE字段的值 DSNTIPP1:

表 1. 绑定服务选项所需的权限
绑定选项 安装面板字段 绑定新包(绑定NV子系统参数) 运行BIND PACKAGE需要授权
使用默认所有者或主要授权ID添加 BINDADD 主授权ID或角色必须具有以下权限之一,才能向收藏中添加新软件包:
  • BINDADD系统特权以及CREATE IN特权或PACKADM权限,适用于单个或所有收藏
  • SYSADM、SYSCTRL或系统DBADM权限
使用默认所有者或主要授权ID添加 BIND 主授权ID或角色必须具有以下权限之一,才能向收藏中添加新软件包:
  • BINDADD系统特权以及CREATE IN特权或PACKADM权限,适用于单个或所有收藏
  • SYSADM、SYSCTRL或系统DBADM权限
  • 对集合或所有集合的 PACKADM 权限
  • BIND软件包特权
添加,指定除主要授权ID1 之外的另一个所有者 BINDADD

如果进程的任何授权ID或角色具有SYSADM权限、SYSCTRL权限或系统DBADM权限,则当子系统参数SEPARATE_SECURITY设置为NO时,OWNER 授权ID 可以为任何值。 如果授权ID中包含所有者授予的BINDAGENT权限,则 授权ID 可以将授权者指定为所有者。 否则,OWNER 授权ID 必须是活页夹的主授权ID或次授权ID之一。

如果您指定了所有者 授权IDDb2 会首先检查所有者,然后检查活页夹是否具有必要的活页夹权限。

如果绑定者没有 SYSADM、SYSCTRL 或系统 DBADM 权限,则所有者必须具有以下权限之一才能向集合中添加新软件包:

  • BINDADD系统特权以及CREATE IN特权或PACKADM权限,适用于单个或所有收藏
  • SYSADM、SYSCTRL或系统DBADM权限
添加,指定除主要授权ID1 之外的另一个所有者 BIND

如果进程的任何授权ID或角色具有SYSADM权限、SYSCTRL权限或系统DBADM权限,则当子系统参数SEPARATE_SECURITY设置为NO时,OWNER 授权ID 可以为任何值。 如果授权ID中包含所有者授予的BINDAGENT权限,则 授权ID 可以将授权者指定为所有者。 否则,OWNER 授权ID 必须是活页夹的主授权ID或次授权ID之一。

如果您指定了所有者 授权IDDb2 会首先检查所有者,然后检查活页夹是否具有必要的活页夹权限。

如果绑定者没有 SYSADM、SYSCTRL 或系统 DBADM 权限,则所有者必须具有以下权限之一才能向集合中添加新软件包:

  • BINDADD系统特权以及CREATE IN特权或PACKADM权限,适用于单个或所有收藏
  • SYSADM、SYSCTRL或系统DBADM权限
  • 对集合或所有集合的 PACKADM 权限
  • BIND软件包特权
注:
  1. 如果所有者与装订者均不具备必要的装订权限,且 IFCID 140 跟踪处于活动状态,则系统会记录跟踪记录,其中包含授权失败的详细信息。

绑定服务的语法

阅读语法图跳过可视化语法图 BIND SERVICE (地点名称.1 收藏-ID)名称块DESCRIPTION(描述字符串)OWNER(授权ID) QUALIFIER( 限定词) ACTION(添加)CURRENTDATA(NO)DEFER(PREPARE)NODEFER(PREPARE)DEGREE(1ANY)DESCSTAT(YES)ENCODING(UNICODE)SQLERROR(NOPACKAGE)EXPLAIN(NOYES)GETACCELARCHIVE(NOYES)IMMEDWRITE(NOYES)ISOLATION(CSRRRSURNC)REOPT(NONE2ALWAYS3ONCEAUTO)OPTHINT( ' 提示-ID' )ACCELERATOR( ' 加速器名称' )ACCELERATIONWAITFORDATA( ' nnnn.m' )PATH(,模式名称USER)ROUNDING(CEILINGDOWNFLOORHALFDOWNHALFEVENHALFUPUP)QUERYACCELERATION(NONEENABLEENABLEWITHFAILBACKELIGIBLEALL)RELEASE(COMMITDEALLOCATE)VALIDATE(RUNBIND)CONCURRENTACCESSRESOLUTION(USECURRENTLYCOMMITTEDWAITFOROUTCOME)APREUSE(NONEERRORWARN)APCOMPARE(NONEWARNERROR)BUSTIMESENSITIVE(YESNO)SYSTIMESENSITIVE(YESNO)ARCHIVESENSITIVE(YESNO)APPLCOMPAT( 应用兼容性级别)
注意:
  • 1 仅当指定了复制选项时,才能指定位置名称。
  • 2 NOREOPT(VARS) 可以被指定为 REOPT(NONE) 的同义词
  • 3 REOPT(VARS) 可以被指定为 REOPT(ALWAYS) 的同义词

名称块

阅读语法图跳过可视化语法图NAME( SERVICE-NAME)VERSION(版本号)SQLDDNAME( 数据定义名称)SQLENCODING(EBCDICASCIIUNICODEccsid)DATE(EURISOJISLOCALUSA)TIME(EURISOJISLOCALUSA)DEC(1531)DECDEL(PERIODCOMMA)STRDEL(APOSTROPHEQUOTE)COPY( collection-id.service-name)COPYVER( 版本号)OPTIONS(COMPOSITECOMMAND)

描述 BIND SERVICE

集合标识、名称 (服务名称 )和版本 (版本标识) 选项值用于标识要绑定的 Db2 REST服务的完整名称。 只有在指定了“复制”选项时,才能指定位置名称值

更改开始
地点名称

DBMS的位置,其中绑定 Db2 REST服务及其描述。 必须在 SYSIBM.LOCATIONS 目录表中定义地点名称。 如果该表不存在或数据库管理系统中不存在该表,您将收到一条错误消息。 请参阅 《地点》目录表

默认值为本地数据库管理系统。

收藏-ID
指定包含REST服务包的集合。 最大长度为128字节。 没有缺省值。

collection-id 可以是普通标识符或定界标识符。 collection-id 的分隔符为双引号(" )。如果 collection-id 被分隔,则 Db2 不会将值转换为大写。

如果REST服务的集合标识符值是一个分隔的标识符,则它可以包含以下字符: 大写字母(A–Z )、小写字母(a–z )、数字(0–9 )、下划线(_ )、at符号(@ )、井号(# )和美元符号($

更改开始名称 (服务名称更改结束
更改开始

要绑定的 Db2 REST服务的名称。 Db2 休息服务名称的最大长度为128字节。 没有缺省值。

服务名称可以是未定界或定界的标识符。 服务名称的分隔符是双引号(“)。如果服务名称有分隔符, Db2 不会将值转换为大写。

更改开始如果REST 服务的service-name值是一个分隔的标识符,则它可以包含以下字符: 大写字母(A–Z )、小写字母(a–z )、数字(0–9 )、下划线(_ )、at符号(@ )、井号(# )和美元符号($)。更改结束

更多信息,请参阅名称绑定选项

更改结束
更改开始版本 (版本号)更改结束
更改开始
定义 Db2 REST服务的版本标识符。 版本标识符是最多包含64个字符的SQL标识符,每个字符可以是以下字符之一: 大写字母(A–Z )、小写字母(a–z )、数字(0–9 )、下划线(_ )、at符号(@ )、井号(# )和美元符号($

如果您没有指定版本,则根据是否启用REST服务版本控制来确定默认版本标识符。 如果启用了REST服务版本控制支持,则默认使用“ V1 ”,否则使用空字符串。

更多信息,请参阅版本绑定选项

更改结束
更改开始绑定服务的其他选项更改结束
更改开始

关于语法图中显示的其他选项的描述,请参阅软件包、计划和服务中的绑定和重新绑定选项

更改结束
更改结束

使用说明 BIND SERVICE

数据共享成员的信息追踪
当在 Db2 数据共享成员中发出具有组范围的命令时,该命令也会在所有其他活动成员中运行。 IFICID 090 跟踪记录显示,除了发出原始命令的成员的跟踪记录外, 016.TLPKN5F 相关 ID 的 SYSOPR 授权 ID 也发出了相同的命令。 请参阅 Db2 数据共享中的命令范围
更改结束