本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
用户定义的函数 API
用户定义的函数 API 介绍用于处理函数的 AWS Glue 数据类型和操作。
数据类型
UserDefinedFunction结构
表示与 Hive 用户定义函数 (UDF
) 定义等效的函数。
Fields
-
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
)。所有者类型。
-
创建函数的时间。
-
ResourceUris
– 一系列 ResourceUri 对象,不超过1000个结构。资源 URIs 功能。
-
CatalogId
– 目录ID字符串,长度不少于1或255字节,匹配 Single-line string pattern.函数所在的数据目录的ID。
UserDefinedFunctionInput结构
用于创建或更新用户定义函数的结构。
Fields
-
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个结构。资源 URIs 功能。
Operations
CreateUserDefinedFunction 操作(Python:create_user_defined_function)
在数据目录中创建新函数定义。
Request
-
CatalogId
– 目录ID字符串,长度不少于1或255字节,匹配 Single-line string pattern.要在其中创建函数的数据目录的 ID。如果没有提供,则默认情况下使用 AWS 账户 ID。
-
DatabaseName
– 必填: UTF-8字符串,长度不少于1或255字节,匹配 Single-line string pattern.要在其中创建函数的目录数据库的名称。
-
FunctionInput
– 必填: 一个 UserDefinedFunctionInput 对象。一个
FunctionInput
对象,它定义要在数据目录中创建的函数。
Response
-
无响应参数。
Errors
-
AlreadyExistsException
-
InvalidInputException
-
InternalServiceException
-
EntityNotFoundException
-
OperationTimeoutException
-
ResourceNumberLimitExceededException
-
GlueEncryptionException
UpdateUserDefinedFunction 操作(Python:update_user_defined_function)
在数据目录中更新现有函数定义。
Request
-
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
对象,它重新定义数据目录中的函数。
Response
-
无响应参数。
Errors
-
EntityNotFoundException
-
InvalidInputException
-
InternalServiceException
-
OperationTimeoutException
-
GlueEncryptionException
DeleteUserDefinedFunction 操作(Python:delete_user_defined_function)
从数据目录中删除现有函数定义。
Request
-
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.要删除的函数定义的名称。
Response
-
无响应参数。
Errors
-
EntityNotFoundException
-
InvalidInputException
-
InternalServiceException
-
OperationTimeoutException
GetUserDefinedFunction 操作(Python:get_user_defined_function)
从数据目录中检索指定的函数定义。
Request
-
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.参数的名称。
Response
-
UserDefinedFunction
– 一种 UserDefinedFunction 对象。请求的函数定义。
Errors
-
EntityNotFoundException
-
InvalidInputException
-
InternalServiceException
-
OperationTimeoutException
-
GlueEncryptionException
GetUserDefinedFunctions 操作(Python:get_user_defined_functions)
从数据目录中检索多个函数定义。
Request
-
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.一个可选的函数名称模式字符串,用于筛选返回的函数定义。
-
延续标记 (如果这是延续调用)。
-
MaxResults
– 数字(整数),不低于1或大于1000。要在一个响应中返回的函数的最大数量。
Response
-
UserDefinedFunctions
– 一系列 UserDefinedFunction 对象。请求的函数定义的列表。
-
延续令牌 (如果返回函数的列表不包括最后一个请求的函数)。
Errors
-
EntityNotFoundException
-
InvalidInputException
-
OperationTimeoutException
-
InternalServiceException
-
GlueEncryptionException