Amazon-S3-Importformate für DynamoDB

DynamoDB kann Daten in drei Formaten importieren: DynamoDB CSV und Amazon IonJSON.

CSV

Eine Datei besteht im CSV Format aus mehreren Elementen, die durch Zeilenumbrüche voneinander getrennt sind. Standardmäßig interpretiert DynamoDB die erste Zeile einer Importdatei als Kopfzeile und erwartet, dass Spalten durch Kommata getrennt werden. Sie können auch Kopfzeilen definieren, die angewendet werden, sofern sie mit der Anzahl der Spalten in der Datei übereinstimmen. Wenn Sie Kopfzeilen explizit definieren, wird die erste Zeile der Datei als Werte importiert.

Anmerkung

Beim Import aus CSV Dateien werden alle Spalten mit Ausnahme des Hash-Bereichs und der Schlüssel Ihrer Basistabelle und der Sekundärindizes als DynamoDB-Zeichenfolgen importiert.

Maskieren von doppelten Anführungszeichen mit Escape-Zeichen

Alle doppelten Anführungszeichen, die in der CSV Datei vorkommen, müssen maskiert werden. Wenn sie nicht maskiert werden, wie im folgenden Beispiel, schlägt der Importvorgang fehl:

id,value
"123",Women's Full Lenth Dress

Derselbe Importvorgang ist erfolgreich, wenn die Anführungszeichen mit zwei Sätzen doppelter Anführungszeichen maskiert werden:

id,value
"""123""",Women's Full Lenth Dress

Sobald der Text korrekt maskiert und importiert wurde, wird er wie in der CSV Originaldatei angezeigt:

id,value
"123",Women's Full Lenth Dress

DynamoDB JSON

Eine Datei im JSON DynamoDB-Format kann aus mehreren Item-Objekten bestehen. Jedes einzelne Objekt hat das standardmäßige JSON Marshalling-Format von DynamoDB, und Zeilenumbrüche werden als Elementtrennzeichen verwendet. Als zusätzliche Funktion werden zeitpunktbezogene Exporte standardmäßig als Importquelle unterstützt.

Anmerkung

Neue Zeilen werden als Elementtrennzeichen für eine Datei im JSON DynamoDB-Format verwendet und sollten nicht innerhalb eines Elementobjekts verwendet werden.

[{
    "Item": {
        "Authors": {
            "SS": ["Author1", "Author2"]
        },
        "Dimensions": {
            "S": "8.5 x 11.0 x 1.5"
        },
        "ISBN": {
            "S": "333-3333333333"
        },
        "Id": {
            "N": "103"
        },
        "InPublication": {
            "BOOL": false
        },
        "PageCount": {
            "N": "600"
        },
        "Price": {
            "N": "2000"
        },
        "ProductCategory": {
            "S": "Book"
        },
        "Title": {
            "S": "Book 103 Title"
        }
    }
}]

Anmerkung

Neue Zeilen werden als Elementtrennzeichen für eine Datei im JSON DynamoDB-Format verwendet und sollten nicht innerhalb eines Elementobjekts verwendet werden.

[{
    "Item": {
        "Authors": {
            "SS": ["Author1", "Author2"]
        },
        "Dimensions": {
            "S": "8.5 x 11.0 x 1.5"
        },
        "ISBN": {
            "S": "333-3333333333"
        },
        "Id": {
            "N": "103"
        },
        "InPublication": {
            "BOOL": false
        },
        "PageCount": {
            "N": "600"
        },
        "Price": {
            "N": "2000"
        },
        "ProductCategory": {
            "S": "Book"
        },
        "Title": {
            "S": "Book 103 Title"
        }
    }
},{
    "Item": {
        "Authors": {
            "SS": ["Author1", "Author2"]
        },
        "Dimensions": {
            "S": "8.5 x 11.0 x 1.5"
        },
        "ISBN": {
            "S": "444-444444444"
        },
        "Id": {
            "N": "104"
        },
        "InPublication": {
            "BOOL": false
        },
        "PageCount": {
            "N": "600"
        },
        "Price": {
            "N": "2000"
        },
        "ProductCategory": {
            "S": "Book"
        },
        "Title": {
            "S": "Book 104 Title"
        }
    }
},{
    "Item": {
        "Authors": {
            "SS": ["Author1", "Author2"]
        },
        "Dimensions": {
            "S": "8.5 x 11.0 x 1.5"
        },
        "ISBN": {
            "S": "555-5555555555"
        },
        "Id": {
            "N": "105"
        },
        "InPublication": {
            "BOOL": false
        },
        "PageCount": {
            "N": "600"
        },
        "Price": {
            "N": "2000"
        },
        "ProductCategory": {
            "S": "Book"
        },
        "Title": {
            "S": "Book 105 Title"
        }
    }
}]

Amazon Ion

Amazon Ion ist ein reich typisiertes, selbstbeschreibendes, hierarchisches Datenserialisierungsformat, das entwickelt wurde, um schnelle Entwicklungs-, Entkopplungs- und Effizienzprobleme zu bewältigen, denen sich täglich gegenübersehen, während umfangreiche, serviceorientierte Architekturen entwickelt werden.

Wenn Sie eine Tabelle im Ion-Format exportieren, werden die in der Tabelle verwendeten DynamoDB-Datentypen Ion-Datentypen zugeordnet.

S. Nein.	Konvertierung des Datentyps von Ion zu DynamoDB	B
1	Ion Data Type	DynamoDB Representation
2	string	String (s)
3	bool	Boolean (BOOL)
4	decimal	Number (N)
5	blob	Binary (B)
6	list (with type annotation $dynamodb_SS, $dynamodb_NS, or $dynamodb_BS)	Set (SS, NS, BS)
7	list	List
8	struct	Map

Elemente in einem Ion-Export werden durch Zeilenumbrüche getrennt. Jede Zeile beginnt mit einer Ion-Versionsmarkierung, gefolgt von einem Element im Ion-Format.

Anmerkung

Im folgenden Beispiel haben wir Elemente aus einer ION-formatierten Datei in mehreren Zeilen formatiert, um die Lesbarkeit zu verbessern.

$ion_1_0
[
  {
    Item:{
      Authors:$dynamodb_SS::["Author1","Author2"],
      Dimensions:"8.5 x 11.0 x 1.5",
      ISBN:"333-3333333333",
      Id:103.,
      InPublication:false,
      PageCount:6d2,
      Price:2d3,
      ProductCategory:"Book",
      Title:"Book 103 Title"
    }
  },
  {
    Item:{
      Authors:$dynamodb_SS::["Author1","Author2"],
      Dimensions:"8.5 x 11.0 x 1.5",
      ISBN:"444-4444444444",
      Id:104.,
      InPublication:false,
      PageCount:6d2,
      Price:2d3,
      ProductCategory:"Book",
      Title:"Book 104 Title"
    }
  },
  {
    Item:{
      Authors:$dynamodb_SS::["Author1","Author2"],
      Dimensions:"8.5 x 11.0 x 1.5",
      ISBN:"555-5555555555",
      Id:105.,
      InPublication:false,
      PageCount:6d2,
      Price:2d3,
      ProductCategory:"Book",
      Title:"Book 105 Title"
    }
  }
]