A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!
Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.
Exemplos do Kinesis que usam o Tools for PowerShell V4
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V4 com o Kinesis.
Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
Tópicos
Ações
O código de exemplo a seguir mostra como usar Get-KINRecord.
- Ferramentas para PowerShell V4
-
Exemplo 1: este exemplo mostra como retornar e extrair dados de uma série de um ou mais registros. O iterador fornecido para Get-KINRecord determina a posição inicial dos registros a serem retornados, os quais, nesse exemplo, são capturados em uma variável, $records. Cada registro individual pode acabar sendo acessado indexando a coleção $records. Supondo que os dados no registro sejam texto codificado em UTF-8, o comando final mostra como você pode extrair os dados do MemoryStream no objeto e retorná-los como texto ao console.
$records $records = Get-KINRecord -ShardIterator "AAAAAAAAAAGIc....9VnbiRNaP"Saída:
MillisBehindLatest NextShardIterator Records ------------------ ----------------- ------- 0 AAAAAAAAAAERNIq...uDn11HuUs {Key1, Key2}$records.Records[0]Saída:
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())Saída:
test data from string-
Para obter detalhes da API, consulte GetRecords em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-KINShardIterator.
- Ferramentas para PowerShell V4
-
Exemplo 1: retorna um iterador do fragmento e a posição inicial especificados. Detalhes dos identificadores de fragmento e dos números de sequência podem ser obtidos na saída do cmdlet Get-KINStream, fazendo referência à coleção de fragmentos do objeto de fluxo retornado. O iterador retornado pode ser usado com o cmdlet Get-KINRecord para extrair registros de dados no fragmento.
Get-KINShardIterator -StreamName "mystream" -ShardId "shardId-000000000000" -ShardIteratorType AT_SEQUENCE_NUMBER -StartingSequenceNumber "495598645..."Saída:
AAAAAAAAAAGIc....9VnbiRNaP-
Para obter detalhes da API, consulte GetShardIterator em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Get-KINStream.
- Ferramentas para PowerShell V4
-
Exemplo 1: retorna detalhes do fluxo especificado.
Get-KINStream -StreamName "mystream"Saída:
HasMoreShards : False RetentionPeriodHours : 24 Shards : {} StreamARN : arn:aws:kinesis:us-west-2:123456789012:stream/mystream StreamName : mystream StreamStatus : ACTIVE-
Para obter detalhes da API, consulte DescribeStream em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar New-KINStream.
- Ferramentas para PowerShell V4
-
Exemplo 1: cria um novo fluxo. Por padrão, esse cmdlet não retorna nenhuma saída, então a opção -PassThru é adicionada para retornar o valor fornecido ao parâmetro -StreamName para uso posterior.
$streamName = New-KINStream -StreamName "mystream" -ShardCount 1 -PassThru-
Para obter detalhes da API, consulte CreateStream em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Remove-KINStream.
- Ferramentas para PowerShell V4
-
Exemplo 1: exclui o fluxo especificado. A confirmação será solicitada antes que a operação continue. Para ignorar o prompt de confirmação, use a opção -Force.
Remove-KINStream -StreamName "mystream"-
Para obter detalhes da API, consulte DeleteStream em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
O código de exemplo a seguir mostra como usar Write-KINRecord.
- Ferramentas para PowerShell V4
-
Exemplo 1: grava um registro contendo a string fornecida para o parâmetro -Text.
Write-KINRecord -Text "test data from string" -StreamName "mystream" -PartitionKey "Key1"Exemplo 2: grava um registro contendo os dados contidos no arquivo especificado. O arquivo é tratado como uma sequência de bytes, portanto, se contiver texto, ele deverá ser gravado com qualquer codificação necessária antes de ser usado com esse cmdlet.
Write-KINRecord -FilePath "C:\TestData.txt" -StreamName "mystream" -PartitionKey "Key2"-
Para obter detalhes da API, consulte PutRecord em Referência de cmdlet do Ferramentas da AWS para PowerShell (V4).
-
