PDF (US Ltr) - 1.2Mb
PDF (A4) - 1.2Mb
建立集合後,即可儲存 JSON 文件。您透過將 JSON 資料結構傳遞至 Collection.add()
函式來儲存文件。某些語言直接支援 JSON 資料,其他語言則具有表示該資料的對等語法。實作 X DevAPI 的 MySQL 連接器旨在實作對連接器特定語言原生之所有 JSON 方法的支援。
此外,在某些 MySQL 連接器中,可以使用通用的 DbDoc
物件。建立它們最方便的方法是呼叫 Collection.newDoc()
。DbDoc
是一種資料類型,用於表示 JSON 文件,而其實作方式並未由 X DevAPI 定義。實作 X DevAPI 的語言可以自由地遵循具有 getter 和 setter 方法的物件導向方法,或使用具有公有成員的 C 結構樣式。
對於嚴格型別語言,可以根據集合的文件結構定義建立類別檔案。MySQL Shell 可用於建立這些檔案。
表 5.1 不同類型文件物件、其支援語言及其優點
文件物件 |
支援語言 |
優點 |
---|---|---|
原生 JSON |
指令碼語言 (JavaScript、Python) |
易於使用 |
JSON 對等語法 |
C# (匿名類型、ExpandoObject) |
易於使用 |
DbDoc |
所有語言 |
在各語言間統一 |
產生的 Doc 類別 |
嚴格型別語言 (C#) |
自然使用 |
以下範例顯示將文件插入集合的不同方法。
// Create a new collection 'my_collection'
var myColl = db.createCollection('my_collection');
// Insert JSON data directly
myColl.add({_id: '8901', name: 'Mats', age: 21}).execute();
// Inserting several docs at once
myColl.add([ {_id: '8902', name: 'Lotte', age: 24},
{_id: '8903', name: 'Vera', age: 39} ]).execute();