View a markdown version of this page

使用 GetShardIterator 用 Amazon SDK 或 CLI - Amazon Kinesis Data Streams
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用 GetShardIterator 用 Amazon SDK 或 CLI

以下代码示例显示了如何使用 GetShardIterator。

操作示例是大型程序的代码摘录,必须在上下文中运行。在以下代码示例中,您可以查看此操作的上下文:

CLI
Amazon CLI

获取分片迭代器

以下 get-shard-iterator 示例使用 AT_SEQUENCE_NUMBER 分片迭代器类型并生成分片迭代器,以便从指定序列号所表示的位置开始精确读取数据记录。

aws kinesis get-shard-iterator \ --stream-name samplestream \ --shard-id shardId-000000000001 \ --shard-iterator-type LATEST

输出:

{ "ShardIterator": "AAAAAAAAAAFEvJjIYI+3jw/4aqgH9FifJ+n48XWTh/IFIsbILP6o5eDueD39NXNBfpZ10WL5K6ADXk8w+5H+Qhd9cFA9k268CPXCz/kebq1TGYI7Vy+lUkA9BuN3xvATxMBGxRY3zYK05gqgvaIRn94O8SqeEqwhigwZxNWxID3Ej7YYYcxQi8Q/fIrCjGAy/n2r5Z9G864YpWDfN9upNNQAR/iiOWKs" }

有关更多信息,请参阅 使用 Kinesis 数据流 API 开发消费者 Amazon Java 软件开发工具包 在 亚马逊 Kinesis 数据流开发者指南。

  • 有关 API 的详细信息,请参阅 GetShardIterator 在 Amazon CLI 命令参考。

PowerShell
用途的工具 PowerShell V4

示例 1:返回指定分片和起始位置的分片迭代器。分片标识符和序列号的详细信息可以从的输出中获得 Get-KINStream cmdlet,通过引用返回的流对象的分片集合。返回的迭代器可以与 Get-KINRecord cmdlet 用于提取分片中的数据记录。

Get-KINShardIterator -StreamName "mystream" -ShardId "shardId-000000000000" -ShardIteratorType AT_SEQUENCE_NUMBER -StartingSequenceNumber "495598645..."

输出:

AAAAAAAAAAGIc....9VnbiRNaP
  • 有关 API 的详细信息,请参阅 GetShardIterator 在 Amazon Tools for PowerShell Cmdlet 参考手册 (V4)。

用途的工具 PowerShell V5

示例 1:返回指定分片和起始位置的分片迭代器。分片标识符和序列号的详细信息可以从的输出中获得 Get-KINStream cmdlet,通过引用返回的流对象的分片集合。返回的迭代器可以与 Get-KINRecord cmdlet 用于提取分片中的数据记录。

Get-KINShardIterator -StreamName "mystream" -ShardId "shardId-000000000000" -ShardIteratorType AT_SEQUENCE_NUMBER -StartingSequenceNumber "495598645..."

输出:

AAAAAAAAAAGIc....9VnbiRNaP
  • 有关 API 的详细信息,请参阅 GetShardIterator 在 Amazon Tools for PowerShell Cmdlet 参考手册 (V5)。

Python
适用于 Python 的 SDK(Boto3)
注意

还有更多关于 GitHub。在 Amazon 代码示例存储库中查找完整示例,了解如何进行设置和运行。

def get_shard_iterator(self, stream_name, shard_id, iterator_type="TRIM_HORIZON"): """ Gets a shard iterator for reading data records from a shard. :param stream_name: The name of the stream. :param shard_id: The ID of the shard. :param iterator_type: The shard iterator type (e.g., TRIM_HORIZON, LATEST). :return: A shard iterator string. """ try: response = self.kinesis_client.get_shard_iterator( StreamName=stream_name, ShardId=shard_id, ShardIteratorType=iterator_type, ) shard_iterator = response.get("ShardIterator", None) logger.info( "Got shard iterator for shard '%s' of type '%s'.", shard_id, iterator_type, ) return shard_iterator except ClientError as err: if err.response["Error"]["Code"] == "ResourceNotFoundException": logger.error( "Stream '%s' or shard '%s' not found. Verify shard ID is correct.", stream_name, shard_id, ) raise
  • 有关 API 的详细信息,请参阅 GetShardIterator 在 Amazon 适用于 Python 的 SDK (Boto3) API 参考。

如需查看完整清单 Amazon SDK 开发者指南和代码示例,请参阅 将此服务与 Amazon SDK。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。