Weitere AWS SDK-Beispiele sind im [AWS Doc SDK Examples ](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub Repo verfügbar. Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # DynamoDB-Beispiele mit Tools für V5 PowerShell Die folgenden Codebeispiele zeigen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V5 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. **Topics** + [Aktionen](#actions) ## Aktionen ### `Add-DDBIndexSchema` Das folgende Codebeispiel zeigt die Verwendung. `Add-DDBIndexSchema` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Add-DDBKeySchema` Das folgende Codebeispiel zeigt die Verwendung. `Add-DDBKeySchema` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `ConvertFrom-DDBItem` Das folgende Codebeispiel zeigt die Verwendung. `ConvertFrom-DDBItem` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `ConvertTo-DDBItem` Das folgende Codebeispiel zeigt die Verwendung. `ConvertTo-DDBItem` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Get-DDBBatchItem` Das folgende Codebeispiel zeigt die Verwendung. `Get-DDBBatchItem` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Get-DDBItem` Das folgende Codebeispiel zeigt die Verwendung. `Get-DDBItem` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Get-DDBTable` Das folgende Codebeispiel zeigt die Verwendung. `Get-DDBTable` **Tools für PowerShell V5** **Beispiel 1: Gibt Details der angegebenen Tabelle zurück.** ``` Get-DDBTable -TableName "myTable" ``` + API-Details finden Sie [ DescribeTable ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Get-DDBTableList` Das folgende Codebeispiel zeigt die Verwendung. `Get-DDBTableList` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Invoke-DDBQuery` Das folgende Codebeispiel zeigt die Verwendung. `Invoke-DDBQuery` **Tools für PowerShell V5** **Beispiel 1: Ruft eine Abfrage auf, die DynamoDB-Elemente mit dem angegebenen und Artist zurückgibt. SongTitle ** ``` $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](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*. ### `Invoke-DDBScan` Das folgende Codebeispiel zeigt die Verwendung`Invoke-DDBScan`. **Tools für PowerShell V5** **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](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell -Cmdlet-Referenz (V5)*. ### `New-DDBTable` Das folgende Codebeispiel zeigt die Verwendung`New-DDBTable`. **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `New-DDBTableSchema` Das folgende Codebeispiel zeigt die Verwendung. `New-DDBTableSchema` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Remove-DDBItem` Das folgende Codebeispiel zeigt die Verwendung. `Remove-DDBItem` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Remove-DDBTable` Das folgende Codebeispiel zeigt die Verwendung. `Remove-DDBTable` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Set-DDBBatchItem` Das folgende Codebeispiel zeigt die Verwendung. `Set-DDBBatchItem` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Set-DDBItem` Das folgende Codebeispiel zeigt die Verwendung. `Set-DDBItem` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Update-DDBItem` Das folgende Codebeispiel zeigt die Verwendung. `Update-DDBItem` **Tools für PowerShell V5** **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 ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). * ### `Update-DDBTable` Das folgende Codebeispiel zeigt die Verwendung. `Update-DDBTable` **Tools für PowerShell V5** **Beispiel 1: Aktualisiert den bereitgestellten Durchsatz für die angegebene Tabelle.** ``` Update-DDBTable -TableName "myTable" -ReadCapacity 10 -WriteCapacity 5 ``` + API-Details finden Sie [ UpdateTable ](https://docs.aws.amazon.com/powershell/v5/reference) in der *AWS -Tools für PowerShell Cmdlet-Referenz (V5). *