本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 GetShardIterator 用 Amazon SDK 或 CLI
以下代码示例显示了如何使用 GetShardIterator。
操作示例是大型程序的代码摘录,必须在上下文中运行。在以下代码示例中,您可以查看此操作的上下文:
- CLI
-
- Amazon CLI
-
获取分片迭代器
以下
get-shard-iterator示例使用AT_SEQUENCE_NUMBER分片迭代器类型并生成分片迭代器,以便从指定序列号所表示的位置开始精确读取数据记录。aws kinesis get-shard-iterator \ --stream-namesamplestream\ --shard-idshardId-000000000001\ --shard-iterator-typeLATEST输出:
{ "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 版本的详细信息。