用户定义的函数 API - Amazon Glue
 —  数据类型  —UserDefinedFunctionUserDefinedFunctionInput —  操作  —CreateUserDefinedFunction (create_user_defined_function)UpdateUserDefinedFunction (update_user_defined_function)DeleteUserDefinedFunction (delete_user_defined_function)GetUserDefinedFunction (get_user_defined_function)GetUserDefinedFunctions (get_user_defined_functions)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

用户定义的函数 API

用户定义的函数 API 介绍用于处理函数的 Amazon Glue 数据类型和操作。

数据类型

UserDefinedFunction 结构

表示与 Hive 用户定义函数 (UDF) 定义等效的函数。

字段

  • 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。

UserDefinedFunctionInput 结构

用于创建或更新用户定义函数的结构。

字段

  • 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）

在数据目录中创建新函数定义。

请求

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

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

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

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

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

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

响应

  • 无响应参数。

错误

  • AlreadyExistsException

  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • GlueEncryptionException

UpdateUserDefinedFunction 操作（Python：update_user_defined_function）

在数据目录中更新现有函数定义。

请求

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

    要更新的函数所在的数据目录的 ID。如果没有提供，则默认情况下使用 Amazon 账户 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

DeleteUserDefinedFunction 操作（Python：delete_user_defined_function）

从数据目录中删除现有函数定义。

请求

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

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

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

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

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

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

响应

  • 无响应参数。

错误

  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

GetUserDefinedFunction 操作（Python：get_user_defined_function）

从数据目录中检索指定的函数定义。

请求

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

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

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

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

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

    函数的名称。

响应
错误

  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • GlueEncryptionException

GetUserDefinedFunctions 操作（Python：get_user_defined_functions）

从数据目录中检索多个函数定义。

请求

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

    要检索的函数所在的数据目录的 ID。如果没有提供，则默认情况下使用 Amazon 账户 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