Eventi
Ottieni gratuitamente la certificazione in Microsoft Fabric.
19 nov, 23 - 10 dic, 23
Per un periodo di tempo limitato, il team della community di Microsoft Fabric offre buoni per esami DP-600 gratuiti.
Prepara oraQuesto browser non è più supportato.
Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.
SI APPLICA A: NoSQL
I contenitori in Azure Cosmos DB archiviano set di elementi. Prima di poter creare, eseguire query o gestire elementi, è necessario creare un contenitore.
In Azure Cosmos DB, un contenitore è analogo a una tabella in un database relazionale. Quando si crea un contenitore, il nome del contenitore costituisce un segmento dell'URI usato per accedere alla risorsa del contenitore e a qualsiasi elemento figlio.
Ecco alcune regole rapide per la denominazione di un contenitore:
Dopo la creazione, l'URI per un contenitore è in questo formato:
https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>/colls/<container-name>
Suggerimento
Per altre informazioni sui limiti dei nomi dei contenitori, consultare quote e limiti del servizio
Per creare un contenitore, usare uno dei metodi seguenti:
Nell'esempio seguente viene creato un contenitore in modo asincrono:
// New instance of Container class referencing the server-side container
Container container1 = await database.CreateContainerAsync(
id: "products-1",
partitionKeyPath: "/category",
throughput: 400
);
Il metodo Database.CreateContainerAsync
genera un'eccezione se esiste già un database con lo stesso nome.
Nell'esempio seguente viene creato un contenitore in modo asincrono solo se non ne esiste già uno nell'account:
// New instance of Container class referencing the server-side container
Container container2 = await database.CreateContainerIfNotExistsAsync(
id: "products-2",
partitionKeyPath: "/category",
throughput: 400
);
Il metodo Database.CreateContainerIfNotExistsAsync
crea un nuovo contenitore solo se non ne esiste già uno. Questo metodo è utile per evitare errori se si esegue lo stesso codice più volte.
In tutti gli esempi riportati fino a questo punto, la risposta dalla richiesta asincrona è stata immediatamente trasmessa al tipo di Container
. È possibile analizzare i metadati relativi alla risposta, incluse le intestazioni e il codice di stato HTTP. Il tipo restituito true per i metodi Database.CreateContainerAsync e Database.CreateContainerIfNotExistsAsync è ContainerResponse
.
Nell'esempio seguente viene illustrato il metodo Database.CreateContainerIfNotExistsAsync che restituisce un ContainerResponse. Una volta restituito, è possibile analizzare le proprietà della risposta e quindi eventualmente ottenere l'oggetto Contenitore sottostante:
// New instance of Container class referencing the server-side container
ContainerResponse response = await database.CreateContainerIfNotExistsAsync(
id: "products-3",
partitionKeyPath: "/category",
throughput: 400
);
// Parse additional response properties
Container container3 = response.Container;
Dopo aver creato un contenitore, usare la guida successiva per creare elementi.
Eventi
Ottieni gratuitamente la certificazione in Microsoft Fabric.
19 nov, 23 - 10 dic, 23
Per un periodo di tempo limitato, il team della community di Microsoft Fabric offre buoni per esami DP-600 gratuiti.
Prepara ora