DynamoDB-Beispiele mit Tools für V4 PowerShell

Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V4 mit DynamoDB verwenden.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.

Themen

Aktionen

Aktionen

Das folgende Codebeispiel zeigt die Verwendung. Add-DDBIndexSchema

Tools für PowerShell V4

Beispiel 1: Erstellt ein leeres TableSchema Objekt und fügt ihm eine neue lokale sekundäre Indexdefinition hinzu, bevor das TableSchema Objekt in die Pipeline geschrieben wird.


$schema | Add-DDBIndexSchema -IndexName "LastPostIndex" -RangeKeyName "LastPostDateTime" -RangeKeyDataType "S" -ProjectionType "keys_only"
$schema = New-DDBTableSchema

Ausgabe:


AttributeSchema                             KeySchema                                   LocalSecondaryIndexSchema
---------------                             ---------                                   -------------------------
{LastPostDateTime}                          {}                                          {LastPostIndex}

Beispiel 2: Fügt dem bereitgestellten TableSchema Objekt eine neue lokale sekundäre Indexdefinition hinzu, bevor das TableSchema Objekt zurück in die Pipeline geschrieben wird. Das TableSchema Objekt kann auch mit dem Parameter -Schema bereitgestellt werden.


New-DDBTableSchema | Add-DDBIndexSchema -IndexName "LastPostIndex" -RangeKeyName "LastPostDateTime" -RangeKeyDataType "S" -ProjectionType "keys_only"

Ausgabe:


AttributeSchema                             KeySchema                                   LocalSecondaryIndexSchema
---------------                             ---------                                   -------------------------
{LastPostDateTime}                          {}                                          {LastPostIndex}

API-Details finden Sie Add-DDBIndexSchema in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Add-DDBKeySchema

Tools für PowerShell V4

Beispiel 1: Erstellt ein leeres TableSchema Objekt und fügt ihm mithilfe der angegebenen Schlüsseldaten Schlüssel- und Attributdefinitionseinträge hinzu, bevor das TableSchema Objekt in die Pipeline geschrieben wird. Der Schlüsseltyp ist standardmäßig als 'HASH' deklariert; verwenden Sie den KeyType Parameter - mit dem Wert 'RANGE', um einen Bereichsschlüssel zu deklarieren.


$schema = New-DDBTableSchema
$schema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"

Ausgabe:


AttributeSchema                             KeySchema                                   LocalSecondaryIndexSchema
---------------                             ---------                                   -------------------------
{ForumName}                                 {ForumName}                                 {}

Beispiel 2: Fügt dem bereitgestellten TableSchema Objekt neue Schlüssel- und Attributdefinitionseinträge hinzu, bevor das TableSchema Objekt in die Pipeline geschrieben wird. Der Schlüsseltyp ist standardmäßig als 'HASH' deklariert; verwenden Sie den KeyType Parameter - mit dem Wert 'RANGE', um einen Bereichsschlüssel zu deklarieren. Das TableSchema Objekt kann auch mithilfe des -Schema-Parameters bereitgestellt werden.


New-DDBTableSchema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"

Ausgabe:


AttributeSchema                             KeySchema                                   LocalSecondaryIndexSchema
---------------                             ---------                                   -------------------------
{ForumName}                                 {ForumName}                                 {}

API-Details finden Sie Add-DDBKeySchema in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. ConvertFrom-DDBItem

Tools für PowerShell V4

Beispiel 1: ConvertFrom-DDBItem wird verwendet, um das Ergebnis einer Hashtabelle Get-DDBItem von DynamoDB in eine Hashtabelle gängiger Typen wie string und double AttributeValues zu konvertieren.


@{
    SongTitle = 'Somewhere Down The Road'
    Artist    = 'No One You Know'
} | ConvertTo-DDBItem

Get-DDBItem -TableName 'Music' -Key $key | ConvertFrom-DDBItem

Ausgabe:


Name                           Value
----                           -----
Genre                          Country
Artist                         No One You Know
Price                          1.94
CriticRating                   9
SongTitle                      Somewhere Down The Road
AlbumTitle                     Somewhat Famous

API-Details finden Sie ConvertFrom-DDBItem in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. ConvertTo-DDBItem

Tools für PowerShell V4

Beispiel 1: Ein Beispiel für die Konvertierung einer Hash-Tabelle in ein Wörterbuch mit DynamoDB-Attributwerten.


@{
    SongTitle = 'Somewhere Down The Road'
    Artist    = 'No One You Know'
} | ConvertTo-DDBItem

Key       Value
---       -----
SongTitle Amazon.DynamoDBv2.Model.AttributeValue
Artist    Amazon.DynamoDBv2.Model.AttributeValue

Beispiel 2: Ein Beispiel für die Konvertierung einer Hash-Tabelle in ein Wörterbuch mit DynamoDB-Attributwerten.


@{
    MyMap        = @{
        MyString = 'my string'
    }
    MyStringSet  = [System.Collections.Generic.HashSet[String]]@('my', 'string')
    MyNumericSet = [System.Collections.Generic.HashSet[Int]]@(1, 2, 3)
    MyBinarySet  = [System.Collections.Generic.HashSet[System.IO.MemoryStream]]@(
        ([IO.MemoryStream]::new([Text.Encoding]::UTF8.GetBytes('my'))),
        ([IO.MemoryStream]::new([Text.Encoding]::UTF8.GetBytes('string')))
    )
    MyList1      = @('my', 'string')
    MyList2      = [System.Collections.Generic.List[Int]]@(1, 2)
    MyList3      = [System.Collections.ArrayList]@('one', 2, $true)
} | ConvertTo-DDBItem

Ausgabe:


Key          Value
---          -----
MyStringSet  Amazon.DynamoDBv2.Model.AttributeValue
MyList1      Amazon.DynamoDBv2.Model.AttributeValue
MyNumericSet Amazon.DynamoDBv2.Model.AttributeValue
MyList2      Amazon.DynamoDBv2.Model.AttributeValue
MyBinarySet  Amazon.DynamoDBv2.Model.AttributeValue
MyMap        Amazon.DynamoDBv2.Model.AttributeValue
MyList3      Amazon.DynamoDBv2.Model.AttributeValue

API-Details finden Sie ConvertTo-DDBItem in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-DDBBatchItem

Tools für PowerShell V4

Beispiel 1: Ruft das Objekt mit dem Titel SongTitle „Somewhere Down The Road“ aus den DynamoDB-Tabellen „Music“ und „Songs“ ab.


$key = @{
    SongTitle = 'Somewhere Down The Road'
    Artist = 'No One You Know'
} | ConvertTo-DDBItem

$keysAndAttributes = New-Object Amazon.DynamoDBv2.Model.KeysAndAttributes
$list = New-Object 'System.Collections.Generic.List[System.Collections.Generic.Dictionary[String, Amazon.DynamoDBv2.Model.AttributeValue]]'
$list.Add($key)
$keysAndAttributes.Keys = $list

$requestItem = @{
    'Music' = [Amazon.DynamoDBv2.Model.KeysAndAttributes]$keysAndAttributes
    'Songs' = [Amazon.DynamoDBv2.Model.KeysAndAttributes]$keysAndAttributes
}

$batchItems = Get-DDBBatchItem -RequestItem $requestItem
$batchItems.GetEnumerator() | ForEach-Object {$PSItem.Value} | ConvertFrom-DDBItem

Ausgabe:


Name                           Value
----                           -----
Artist                         No One You Know
SongTitle                      Somewhere Down The Road
AlbumTitle                     Somewhat Famous
CriticRating                   10
Genre                          Country
Price                          1.94
Artist                         No One You Know
SongTitle                      Somewhere Down The Road
AlbumTitle                     Somewhat Famous
CriticRating                   10
Genre                          Country
Price                          1.94

API-Details finden Sie BatchGetItem in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-DDBItem

Tools für PowerShell V4

Beispiel 1: Gibt das DynamoDB-Element mit dem Partitionsschlüssel SongTitle und dem Sortierschlüssel Artist zurück.


$key = @{
  SongTitle = 'Somewhere Down The Road'
  Artist = 'No One You Know'
} | ConvertTo-DDBItem

Get-DDBItem -TableName 'Music' -Key $key | ConvertFrom-DDBItem

Ausgabe:


Name                           Value
----                           -----
Genre                          Country
SongTitle                      Somewhere Down The Road
Price                          1.94
Artist                         No One You Know
CriticRating                   9
AlbumTitle                     Somewhat Famous

API-Details finden Sie GetItem in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-DDBTable

Tools für PowerShell V4

Beispiel 1: Gibt Details der angegebenen Tabelle zurück.


Get-DDBTable -TableName "myTable"

API-Details finden Sie DescribeTable in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Get-DDBTableList

Tools für PowerShell V4

Beispiel 1: Gibt Details aller Tabellen zurück und iteriert automatisch, bis der Service anzeigt, dass keine weiteren Tabellen vorhanden sind.


Get-DDBTableList

API-Details finden Sie ListTables in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Invoke-DDBQuery

Tools für PowerShell V4

Beispiel 1: Ruft eine Abfrage auf, die DynamoDB-Elemente mit dem angegebenen SongTitle und Artist zurückgibt.


$invokeDDBQuery = @{
    TableName = 'Music'
    KeyConditionExpression = ' SongTitle = :SongTitle and Artist = :Artist'
    ExpressionAttributeValues = @{
        ':SongTitle' = 'Somewhere Down The Road'
        ':Artist' = 'No One You Know'
    } | ConvertTo-DDBItem
}
Invoke-DDBQuery @invokeDDBQuery | ConvertFrom-DDBItem

Ausgabe:


Name                           Value
----                           -----
Genre                          Country
Artist                         No One You Know
Price                          1.94
CriticRating                   9
SongTitle                      Somewhere Down The Road
AlbumTitle                     Somewhat Famous

Weitere API-Informationen finden Sie unter Abfragen in der AWS -Tools für PowerShell -Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die VerwendungInvoke-DDBScan.

Tools für PowerShell V4

Beispiel 1: Gibt alle Elemente in der Tabelle „Music“ zurück.


Invoke-DDBScan -TableName 'Music' | ConvertFrom-DDBItem

Ausgabe:


Name                           Value
----                           -----
Genre                          Country
Artist                         No One You Know
Price                          1.94
CriticRating                   9
SongTitle                      Somewhere Down The Road
AlbumTitle                     Somewhat Famous
Genre                          Country
Artist                         No One You Know
Price                          1.98
CriticRating                   8.4
SongTitle                      My Dog Spot
AlbumTitle                     Hey Now

Beispiel 2: Gibt Elemente in der Musik-Tabelle zurück, deren Wert CriticRating größer oder gleich neun ist.


$scanFilter = @{
        CriticRating = [Amazon.DynamoDBv2.Model.Condition]@{
            AttributeValueList = @(@{N = '9'})
            ComparisonOperator = 'GE'
        }
    }
    Invoke-DDBScan -TableName 'Music' -ScanFilter $scanFilter | ConvertFrom-DDBItem

Ausgabe:


Name                           Value
----                           -----
Genre                          Country
Artist                         No One You Know
Price                          1.94
CriticRating                   9
SongTitle                      Somewhere Down The Road
AlbumTitle                     Somewhat Famous

Weitere API-Informationen finden Sie unter Scan in der AWS -Tools für PowerShell -Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die VerwendungNew-DDBTable.

Tools für PowerShell V4

Beispiel 1: In diesem Beispiel wird eine Tabelle mit dem Namen Thread erstellt, die einen Primärschlüssel hat, der aus ForumName '(Schlüsseltyp-Hash) und' Subject '(Schlüsseltypbereich) besteht. Das zur Erstellung der Tabelle verwendete Schema kann wie gezeigt an jedes Cmdlet übergeben oder mit dem Parameter „-Schema“ angegeben werden.


$schema = New-DDBTableSchema
$schema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"
$schema | Add-DDBKeySchema -KeyName "Subject" -KeyType RANGE -KeyDataType "S"
$schema | New-DDBTable -TableName "Thread" -ReadCapacity 10 -WriteCapacity 5

Ausgabe:


AttributeDefinitions   : {ForumName, Subject}
TableName              : Thread
KeySchema              : {ForumName, Subject}
TableStatus            : CREATING
CreationDateTime       : 10/28/2013 4:39:49 PM
ProvisionedThroughput  : Amazon.DynamoDBv2.Model.ProvisionedThroughputDescription
TableSizeBytes         : 0
ItemCount              : 0
LocalSecondaryIndexes  : {}

Beispiel 2: In diesem Beispiel wird eine Tabelle mit dem Namen Thread erstellt, die einen Primärschlüssel hat, der aus ForumName '(Schlüsseltyp-Hash) und' Subject '(Schlüsseltypbereich) besteht. Ein lokaler sekundärer Index wird ebenfalls definiert. Der Schlüssel des lokalen sekundären Indexes wird automatisch anhand des primären Hashschlüssels in der Tabelle (ForumName) festgelegt. Das zur Erstellung der Tabelle verwendete Schema kann wie gezeigt an jedes Cmdlet übergeben oder mit dem Parameter „-Schema“ angegeben werden.


$schema = New-DDBTableSchema
$schema | Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S"
$schema | Add-DDBKeySchema -KeyName "Subject" -KeyDataType "S"
$schema | Add-DDBIndexSchema -IndexName "LastPostIndex" -RangeKeyName "LastPostDateTime" -RangeKeyDataType "S" -ProjectionType "keys_only"
$schema | New-DDBTable -TableName "Thread" -ReadCapacity 10 -WriteCapacity 5

Ausgabe:


AttributeDefinitions   : {ForumName, LastPostDateTime, Subject}
TableName              : Thread
KeySchema              : {ForumName, Subject}
TableStatus            : CREATING
CreationDateTime       : 10/28/2013 4:39:49 PM
ProvisionedThroughput  : Amazon.DynamoDBv2.Model.ProvisionedThroughputDescription
TableSizeBytes         : 0
ItemCount              : 0
LocalSecondaryIndexes  : {LastPostIndex}

Beispiel 3: Dieses Beispiel zeigt, wie eine einzelne Pipeline verwendet wird, um eine Tabelle mit dem Namen Thread zu erstellen, die einen Primärschlüssel enthält, der aus ForumName '' (Schlüsseltyp-Hash) und 'Subject' (Schlüsseltypbereich) besteht, sowie einen lokalen sekundären Index. Add-DDBKeySchema Und Add-DDBIndexSchema erstellen Sie ein neues TableSchema Objekt für Sie, falls keines von der Pipeline oder dem -Schema-Parameter bereitgestellt wird.


New-DDBTableSchema |
  Add-DDBKeySchema -KeyName "ForumName" -KeyDataType "S" |
  Add-DDBKeySchema -KeyName "Subject" -KeyDataType "S" |
  Add-DDBIndexSchema -IndexName "LastPostIndex" `
                     -RangeKeyName "LastPostDateTime" `
                     -RangeKeyDataType "S" `
                     -ProjectionType "keys_only" |
  New-DDBTable -TableName "Thread" -ReadCapacity 10 -WriteCapacity 5

Ausgabe:


AttributeDefinitions   : {ForumName, LastPostDateTime, Subject}
TableName              : Thread
KeySchema              : {ForumName, Subject}
TableStatus            : CREATING
CreationDateTime       : 10/28/2013 4:39:49 PM
ProvisionedThroughput  : Amazon.DynamoDBv2.Model.ProvisionedThroughputDescription
TableSizeBytes         : 0
ItemCount              : 0
LocalSecondaryIndexes  : {LastPostIndex}

API-Details finden Sie CreateTable in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. New-DDBTableSchema

Tools für PowerShell V4

Beispiel 1: Erstellt ein leeres TableSchema Objekt, das bereit ist, Schlüssel- und Indexdefinitionen für die Erstellung einer neuen Amazon DynamoDB-Tabelle zu akzeptieren. Das zurückgegebene Objekt kann über die Pipeline an die Add-DDBKeySchema New-DDBTable Cmdlets Add-DDBIndexSchema und übergeben werden oder mithilfe des -Schema-Parameters für jedes Cmdlet an sie übergeben werden.


New-DDBTableSchema

Ausgabe:


AttributeSchema                             KeySchema                                   LocalSecondaryIndexSchema
---------------                             ---------                                   -------------------------
{}                                          {}                                          {}

API-Details finden Sie New-DDBTableSchema in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Remove-DDBItem

Tools für PowerShell V4

Beispiel 1: Entfernt das DynamoDB-Element, das dem angegebenen Schlüssel entspricht.


$key = @{
    SongTitle = 'Somewhere Down The Road'
    Artist = 'No One You Know'
} | ConvertTo-DDBItem
Remove-DDBItem -TableName 'Music' -Key $key -Confirm:$false

API-Details finden Sie DeleteItem in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Remove-DDBTable

Tools für PowerShell V4

Beispiel 1: Löscht die angegebene Tabelle. Sie werden um eine Bestätigung gebeten, bevor der Vorgang fortgesetzt wird.


Remove-DDBTable -TableName "myTable"

Beispiel 2: Löscht die angegebene Tabelle. Sie werden nicht zum Bestätigen aufgefordert, bevor der Vorgang fortgesetzt wird.


Remove-DDBTable -TableName "myTable" -Force

API-Details finden Sie DeleteTable in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Set-DDBBatchItem

Tools für PowerShell V4

Beispiel 1: Erstellt ein neues Element oder ersetzt ein vorhandenes durch ein neues Element in den DynamoDB-Tabellen „Music“ und „Songs“.


$item = @{
    SongTitle = 'Somewhere Down The Road'
    Artist = 'No One You Know'
    AlbumTitle = 'Somewhat Famous'
    Price = 1.94
    Genre = 'Country'
    CriticRating = 10.0
} | ConvertTo-DDBItem

$writeRequest = New-Object Amazon.DynamoDBv2.Model.WriteRequest
$writeRequest.PutRequest = [Amazon.DynamoDBv2.Model.PutRequest]$item

$requestItem = @{
    'Music' = [Amazon.DynamoDBv2.Model.WriteRequest]($writeRequest)
    'Songs' = [Amazon.DynamoDBv2.Model.WriteRequest]($writeRequest)
}

Set-DDBBatchItem -RequestItem $requestItem

API-Details finden Sie BatchWriteItem in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Set-DDBItem

Tools für PowerShell V4

Beispiel 1: Erstellt ein neues Element oder ersetzt ein vorhandenes Element durch ein neues.


$item = @{
  SongTitle = 'Somewhere Down The Road'
  Artist = 'No One You Know'
        AlbumTitle = 'Somewhat Famous'
        Price = 1.94
        Genre = 'Country'
        CriticRating = 9.0
} | ConvertTo-DDBItem
Set-DDBItem -TableName 'Music' -Item $item

API-Details finden Sie PutItem in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Update-DDBItem

Tools für PowerShell V4

Beispiel 1: Setzt das Genre-Attribut für das DynamoDB-Element mit dem Partitionsschlüssel SongTitle und dem Sortierschlüssel Artist auf „Rap“.


$key = @{
    SongTitle = 'Somewhere Down The Road'
    Artist = 'No One You Know'
} | ConvertTo-DDBItem

$updateDdbItem = @{
    TableName = 'Music'
    Key = $key
    UpdateExpression = 'set Genre = :val1'
    ExpressionAttributeValue = (@{
        ':val1' = ([Amazon.DynamoDBv2.Model.AttributeValue]'Rap')
    })
}
Update-DDBItem @updateDdbItem

Ausgabe:


Name                           Value
----                           -----
Genre                          Rap

API-Details finden Sie UpdateItem in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Das folgende Codebeispiel zeigt die Verwendung. Update-DDBTable

Tools für PowerShell V4

Beispiel 1: Aktualisiert den bereitgestellten Durchsatz für die angegebene Tabelle.


Update-DDBTable -TableName "myTable" -ReadCapacity 10 -WriteCapacity 5

API-Details finden Sie UpdateTable in der AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

AWS DMS

Amazon EC2