D'autres AWS SDK exemples sont disponibles dans le GitHub dépôt AWS Doc SDK Examples
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Exemples de Kinesis utilisant des outils pour PowerShell
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Tools for PowerShell with Kinesis.
Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Les actions vous indiquent comment appeler des fonctions de service individuelles, mais vous pouvez les visualiser dans leur contexte dans les scénarios correspondants.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utiliserGet-KINRecord
.
- Outils pour PowerShell
-
Exemple 1 : Cet exemple montre comment renvoyer et extraire des données d'une série d'un ou de plusieurs enregistrements. L'itérateur fourni à Get- KINRecord détermine la position de départ des enregistrements à renvoyer qui, dans cet exemple, sont capturés dans une variable, $records. Chaque enregistrement individuel est ensuite accessible en indexant la collection $records. En supposant que les données de l'enregistrement sont du texte codé en UTF -8, la commande finale indique comment extraire les données de l' MemoryStream objet et les renvoyer sous forme de texte à la console.
$records $records = Get-KINRecord -ShardIterator "AAAAAAAAAAGIc....9VnbiRNaP"
Sortie :
MillisBehindLatest NextShardIterator Records ------------------ ----------------- ------- 0 AAAAAAAAAAERNIq...uDn11HuUs {Key1, Key2}
$records.Records[0]
Sortie :
ApproximateArrivalTimestamp Data PartitionKey SequenceNumber --------------------------- ---- ------------ -------------- 3/7/2016 5:14:33 PM System.IO.MemoryStream Key1 4955986459776...931586
[Text.Encoding]::UTF8.GetString($records.Records[0].Data.ToArray())
Sortie :
test data from string
-
Pour API plus de détails, consultez la section GetRecordsRéférence des AWS Tools for PowerShell applets de commande.
-
L'exemple de code suivant montre comment utiliserGet-KINShardIterator
.
- Outils pour PowerShell
-
Exemple 1 : renvoie un itérateur de partition pour la partition et la position de départ spécifiées. Les détails des identificateurs de partition et des numéros de séquence peuvent être obtenus à partir de la sortie de l'KINStreamapplet de commande Get-, en faisant référence à la collection Shards de l'objet de flux renvoyé. L'itérateur renvoyé peut être utilisé avec l'KINRecordapplet de commande Get- pour extraire des enregistrements de données dans la partition.
Get-KINShardIterator -StreamName "mystream" -ShardId "shardId-000000000000" -ShardIteratorType AT_SEQUENCE_NUMBER -StartingSequenceNumber "495598645..."
Sortie :
AAAAAAAAAAGIc....9VnbiRNaP
-
Pour API plus de détails, consultez la section GetShardIteratorRéférence des AWS Tools for PowerShell applets de commande.
-
L'exemple de code suivant montre comment utiliserGet-KINStream
.
- Outils pour PowerShell
-
Exemple 1 : renvoie les détails du flux spécifié.
Get-KINStream -StreamName "mystream"
Sortie :
HasMoreShards : False RetentionPeriodHours : 24 Shards : {} StreamARN : arn:aws:kinesis:us-west-2:123456789012:stream/mystream StreamName : mystream StreamStatus : ACTIVE
-
Pour API plus de détails, consultez la section DescribeStreamRéférence des AWS Tools for PowerShell applets de commande.
-
L'exemple de code suivant montre comment utiliserNew-KINStream
.
- Outils pour PowerShell
-
Exemple 1 : crée un nouveau flux. Par défaut, cette applet de commande ne renvoie aucune sortie. Le PassThru commutateur - est donc ajouté pour renvoyer la valeur fournie au StreamName paramètre - pour une utilisation ultérieure.
$streamName = New-KINStream -StreamName "mystream" -ShardCount 1 -PassThru
-
Pour API plus de détails, consultez la section CreateStreamRéférence des AWS Tools for PowerShell applets de commande.
-
L'exemple de code suivant montre comment utiliserRemove-KINStream
.
- Outils pour PowerShell
-
Exemple 1 : Supprime le flux spécifié. Vous êtes invité à confirmer avant l'exécution de la commande. Pour supprimer les demandes de confirmation, utilisez le commutateur -Force.
Remove-KINStream -StreamName "mystream"
-
Pour API plus de détails, consultez la section DeleteStreamRéférence des AWS Tools for PowerShell applets de commande.
-
L'exemple de code suivant montre comment utiliserWrite-KINRecord
.
- Outils pour PowerShell
-
Exemple 1 : écrit un enregistrement contenant la chaîne fournie au paramètre -Text.
Write-KINRecord -Text "test data from string" -StreamName "mystream" -PartitionKey "Key1"
Exemple 2 : écrit un enregistrement contenant les données contenues dans le fichier spécifié. Le fichier est traité comme une séquence d'octets. S'il contient du texte, il doit être écrit avec le codage nécessaire avant de l'utiliser avec cette applet de commande.
Write-KINRecord -FilePath "C:\TestData.txt" -StreamName "mystream" -PartitionKey "Key2"
-
Pour API plus de détails, consultez la section PutRecordRéférence des AWS Tools for PowerShell applets de commande.
-