本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
查询 API
查询 API 允许您共享中管理的数据湖的事务一致性数据Amazon S3、Amazon Redshift和其他Amazon服务。
数据类型
WorkUnit 范围结构
定义用于查询执行服务的工作单元 ID 的有效范围。
字段
GetWorkUnits 响应结构
输出的结构。
字段
-
对返回的标记列表进行分页的延续令牌 (如果列表的当前片段不是最后一个,则返回)。
-
计划查询操作的 ID。
-
WorkUnitRanges
–:必需 WorkUnit 范围 对象数组。一个
WorkUnitRangeList
对象,该对象指定用于查询执行服务的工作单元 ID 的有效范围。
GetQueryState 响应结构
输出的结构。
字段
GetWorkUnit 结果
输出的结构。
查询计划上下文结构
包含有关查询计划信息的结构。
字段
-
CatalogId
– 目录 id 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。所涉分区所在的数据目录的 ID。如果没有提供,则默认情况下使用 Amazon 账户 ID。
-
DatabaseName
–:必需 匹配 UTF-8 字符串,至少 1 个字节,与匹配Single-line string pattern.包含该表的数据库。
-
截至读取表内容的时间。如果未设置,将使用最近的事务提交时间。无法与
TransactionId
一起指定。 -
每个键是一个 UTF-8 字符串。
每个值是一个 UTF-8 字符串。
由键值对组成的映射。
-
TransactionId
– UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Custom string pattern #11 匹配。在该 ID 处读取表内容的事务 ID。如果未提交此事务,则读取将被视为该事务的一部分,并将看到其写入内容。如果此事务已中止,将返回错误。如果未设置,则默认为最近提交的事务。无法与
QueryAsOfTime
一起指定。
执行/统计结构
与处理查询语句相关的统计信息。
字段
规划/统计结构
与处理查询语句相关的统计信息。
字段
操作
StartQueryPlanning 操作(Python:start_query_plan)
提交处理查询语句的请求。
此操作生成的工作单元可以使用GetWorkUnits
只要查询状态为 WORKUNITS_SALABLE 或已完成,就会立即操作。
请求
-
QueryPlanningContext
–:必需 一个 查询规划上下文 对象。包含有关查询计划信息的结构。
-
QueryString
–:必需 UTF-8 字符串,至少为 1 个字节。用作计划程序服务输入的 PartiQL 查询语句。
响应
输出的结构。
错误
InternalServiceException
InvalidInputException
AccessDeniedException
ThrottledException
GetQueryState 操作(Python:get_query_state)
返回之前提交的查询的状态。客户应该进行民意调查GetQueryState
以便在检索工作单元之前监控计划的当前状态。查询状态只对进行初始调用的委托人可见StartQueryPlanning
.
响应
输出的结构。
错误
InternalServiceException
InvalidInputException
AccessDeniedException
GetWorkUnits 操作(Python:get_Work_Units)
检索由StartQueryPlanning
operation.
请求
响应
输出的结构。
-
对返回的标记列表进行分页的延续令牌 (如果列表的当前片段不是最后一个,则返回)。
-
计划查询操作的 ID。
-
WorkUnitRanges
–:必需 WorkUnit 范围 对象数组。一个
WorkUnitRangeList
对象,该对象指定用于查询执行服务的工作单元 ID 的有效范围。
错误
WorkUnitsNotReadyYetException
InternalServiceException
InvalidInputException
AccessDeniedException
ExpiredException
GetWorkUnit 结果操作(Python:get_work_unit_Results)
返回查询生成的工作单元。工作单位可以按任意顺序并行执行。
请求
错误
InternalServiceException
InvalidInputException
AccessDeniedException
ExpiredException
ThrottledException
GetQueryStartyStartyStartyInstistics 操作(Python:get_query_统计)
检索有关计划和执行查询的统计信息。
响应
错误
StatisticsNotReadyYetException
InternalServiceException
InvalidInputException
AccessDeniedException
ExpiredException
ThrottledException
异常
IntoReadyetCreadyet 异常结构
包含有关统计信息未准备就绪的错误的详细信息。
WorkUnteReadyet 异常结构
包含与工作单元尚未准备就绪相关的错误的详细信息。
ExcireExeption 结构
包含有关查询请求过期的错误的详细信息。
CLOTTLEException 结构
包含有关限制查询请求的错误的详细信息。