用户定义的函数 API

• UserDefinedFunction 结构

• UserDefinedFunctionInput 结构

字段

• FunctionName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  函数的名称。

• DatabaseName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  包含函数的目录数据库的名称。

• ClassName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  包含函数代码的 Java 类。

• OwnerName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  参数的所有者。

• OwnerType – UTF-8 字符串（有效值：USER | ROLE | GROUP）。

  所有者类型。

• CreateTime – 时间戳。

  创建函数的时间。

• ResourceUris – ResourceUri 对象数组，不超过 1000 个结构。

  函数的资源 URI。

• CatalogId – 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要在其中创建函数的数据目录的 ID。

字段

• FunctionName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  函数的名称。

• ClassName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  包含函数代码的 Java 类。

• OwnerName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  参数的所有者。

• OwnerType – UTF-8 字符串（有效值：USER | ROLE | GROUP）。

  所有者类型。

• ResourceUris – ResourceUri 对象数组，不超过 1000 个结构。

  函数的资源 URI。

• CreateUserDefinedFunction 操作（Python：create_user_defined_function）

• UpdateUserDefinedFunction 操作（Python：update_user_defined_function）

• DeleteUserDefinedFunction 操作（Python：delete_user_defined_function）

• GetUserDefinedFunction 操作（Python：get_user_defined_function）

• GetUserDefinedFunctions 操作（Python：get_user_defined_functions）

请求

• CatalogId – 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要在其中创建函数的数据目录的 ID。如果没有提供，则默认情况下使用 AWS 账户 ID。

• DatabaseName – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要在其中创建函数的目录数据库的名称。

• FunctionInput – 必填：一个 UserDefinedFunctionInput 对象。

  一个 FunctionInput 对象，它定义要在数据目录中创建的函数。

响应

• 无响应参数。

错误

• AlreadyExistsException

• InvalidInputException

• InternalServiceException

• EntityNotFoundException

• OperationTimeoutException

• ResourceNumberLimitExceededException

• GlueEncryptionException

请求

• CatalogId – 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要更新的函数所在的数据目录的 ID。如果没有提供，则默认情况下使用 AWS 账户 ID。

• DatabaseName – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要更新的函数所在的目录数据库的名称。

• FunctionName – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  函数的名称。

• FunctionInput – 必填：一个 UserDefinedFunctionInput 对象。

  一个 FunctionInput 对象，它重新定义数据目录中的函数。

响应

• 无响应参数。

错误

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

请求

• CatalogId – 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要删除的函数所在的数据目录的 ID。如果没有提供，则默认情况下使用 AWS 账户 ID。

• DatabaseName – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  函数所在的目录数据库的名称。

• FunctionName – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要删除的函数定义的名称。

响应

• 无响应参数。

错误

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

请求

• CatalogId – 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要检索的函数所在的数据目录的 ID。如果没有提供，则默认情况下使用 AWS 账户 ID。

• DatabaseName – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  函数所在的目录数据库的名称。

• FunctionName – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  函数的名称。

响应

• UserDefinedFunction – 一个 UserDefinedFunction 对象。

  请求的函数定义。

错误

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

请求

• CatalogId – 目录 id 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  要检索的函数所在的数据目录的 ID。如果没有提供，则默认情况下使用 AWS 账户 ID。

• DatabaseName – UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  函数所在的目录数据库的名称。如果未提供任何内容，则将返回来自目录中所有数据库的函数。

• Pattern – 必填：UTF-8 字符串，长度不少于 1 个字节或超过 255 个字节，与 Single-line string pattern 匹配。

  一个可选的函数名称模式字符串，用于筛选返回的函数定义。

• NextToken – UTF-8 字符串。

  延续标记 (如果这是延续调用)。

• MaxResults – 数字（整数），不小于 1 或大于 100。

  要在一个响应中返回的函数的最大数量。

响应

• UserDefinedFunctions – UserDefinedFunction 对象的数组。

  请求的函数定义的列表。

• NextToken – UTF-8 字符串。

  延续令牌 (如果返回函数的列表不包括最后一个请求的函数)。

错误

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• GlueEncryptionException