Há mais AWS SDK exemplos disponíveis no GitHub repositório AWS Doc SDK Examples
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Exemplos do Kinesis usando o Tools for PowerShell
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Tools for PowerShell with 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 funções de serviço individuais, é possível ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.
Tópicos
Ações
O código de exemplo a seguir mostra como usar Get-KINRecord
.
- Ferramentas para PowerShell
-
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, neste exemplo, são capturados em uma variável, $records. Cada registro individual pode então ser 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 objeto e retorná-los como texto para o 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 API obter detalhes, consulte GetRecordsem Referência de AWS Tools for PowerShell cmdlet.
-
O código de exemplo a seguir mostra como usar Get-KINShardIterator
.
- Ferramentas para PowerShell
-
Exemplo 1: retorna um iterador de fragmento para o fragmento e a posição inicial especificados. Detalhes dos identificadores de fragmentos e dos números de sequência podem ser obtidos na saída do KINStream cmdlet Get-, fazendo referência à coleção Shards do objeto de fluxo retornado. O iterador retornado pode ser usado com o KINRecord cmdlet Get- 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 API obter detalhes, consulte GetShardIteratorem Referência de AWS Tools for PowerShell cmdlet.
-
O código de exemplo a seguir mostra como usar Get-KINStream
.
- Ferramentas para PowerShell
-
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 API obter detalhes, consulte DescribeStreamem Referência de AWS Tools for PowerShell cmdlet.
-
O código de exemplo a seguir mostra como usar New-KINStream
.
- Ferramentas para PowerShell
-
Exemplo 1: cria um novo fluxo. Por padrão, esse cmdlet não retorna nenhuma saída, então a PassThru opção - é adicionada para retornar o valor fornecido ao StreamName parâmetro - para uso posterior.
$streamName = New-KINStream -StreamName "mystream" -ShardCount 1 -PassThru
-
Para API obter detalhes, consulte CreateStreamem Referência de AWS Tools for PowerShell cmdlet.
-
O código de exemplo a seguir mostra como usar Remove-KINStream
.
- Ferramentas para PowerShell
-
Exemplo 1: exclui o fluxo especificado. Você será solicitado a confirmar antes que o comando seja executado. Para suprimir a solicitação de confirmação, use a opção -Force.
Remove-KINStream -StreamName "mystream"
-
Para API obter detalhes, consulte DeleteStreamem Referência de AWS Tools for PowerShell cmdlet.
-
O código de exemplo a seguir mostra como usar Write-KINRecord
.
- Ferramentas para PowerShell
-
Exemplo 1: grava um registro contendo a string fornecida ao 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 ele 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 API obter detalhes, consulte PutRecordem Referência de AWS Tools for PowerShell cmdlet.
-