DocumentDB - typy danych
JSON lub JavaScript Object Notation to lekki, oparty na tekście, otwarty standard przeznaczony do wymiany danych czytelnych dla człowieka, a także łatwy do analizowania i generowania przez maszyny. JSON jest sercem DocumentDB. Przesyłamy JSON przez sieć, przechowujemy JSON jako JSON i indeksujemy drzewo JSON, umożliwiając zapytania dotyczące pełnego dokumentu JSON.
Format JSON obsługuje następujące typy danych -
S.No. | Typ i opis |
---|---|
1 | Number Format zmiennoprzecinkowy podwójnej precyzji w JavaScript |
2 | String Unicode w podwójnym cudzysłowie z ukośnikiem odwrotnym |
3 | Boolean Prawda czy fałsz |
4 | Array Uporządkowana sekwencja wartości |
5 | Value Może to być ciąg, liczba, prawda lub fałsz, null itp. |
6 | Object Nieuporządkowana kolekcja par klucz: wartość |
7 | Whitespace Można go używać między dowolnymi parami tokenów |
8 | Null Pusty |
Rzućmy okiem na prosty przykład typu DateTime. Dodaj datę urodzenia do klasy klienta.
public class Customer {
[JsonProperty(PropertyName = "id")]
public string Id { get; set; }
// Must be nullable, unless generating unique values for new customers on client
[JsonProperty(PropertyName = "name")]
public string Name { get; set; }
[JsonProperty(PropertyName = "address")]
public Address Address { get; set; }
[JsonProperty(PropertyName = "birthDate")]
public DateTime BirthDate { get; set; }
}
Możemy przechowywać, pobierać i wykonywać zapytania przy użyciu DateTime, jak pokazano w poniższym kodzie.
private async static Task CreateDocuments(DocumentClient client) {
Console.WriteLine();
Console.WriteLine("**** Create Documents ****");
Console.WriteLine();
var document3Definition = new Customer {
Id = "1001",
Name = "Luke Andrew",
Address = new Address {
AddressType = "Main Office",
AddressLine1 = "123 Main Street",
Location = new Location {
City = "Brooklyn",
StateProvinceName = "New York"
},
PostalCode = "11229",
CountryRegionName = "United States"
},
BirthDate = DateTime.Parse(DateTime.Today.ToString()),
};
Document document3 = await CreateDocument(client, document3Definition);
Console.WriteLine("Created document {0} from typed object", document3.Id);
Console.WriteLine();
}
Kiedy powyższy kod zostanie skompilowany i wykonany, a dokument zostanie utworzony, zobaczysz, że data urodzenia została dodana.
**** Create Documents ****
Created new document: 1001
{
"id": "1001",
"name": "Luke Andrew",
"address": {
"addressType": "Main Office",
"addressLine1": "123 Main Street",
"location": {
"city": "Brooklyn",
"stateProvinceName": "New York"
},
"postalCode": "11229",
"countryRegionName": "United States"
},
"birthDate": "2015-12-14T00:00:00",
"_rid": "Ic8LAMEUVgAKAAAAAAAAAA==",
"_ts": 1450113676,
"_self": "dbs/Ic8LAA==/colls/Ic8LAMEUVgA=/docs/Ic8LAMEUVgAKAAAAAAAAAA==/",
"_etag": "\"00002d00-0000-0000-0000-566efa8c0000\"",
"_attachments": "attachments/"
}
Created document 1001 from typed object