Condividi tramite

Creare una raccolta in Azure Cosmos DB for MongoDB

  • Articolo

SI APPLICA A: MongoDB

Questo articolo illustra i diversi modi disponibili per creare una raccolta in Azure Cosmos DB for MongoDB. Mostra come creare una raccolta usando il portale di Azure, l'interfaccia della riga di comando di Azure, PowerShell o gli SDK supportati. Questo articolo illustra come creare una raccolta, specificare la chiave di partizione e effettuare il provisioning della velocità effettiva.

Nota

I contenitori e le raccolte sono simili a una tabella in un database relazionale. Si fa riferimento a contenitori in Azure Cosmos DB for NoSQL e nel portale di Azure, mentre si usa il termine raccolte nel contesto di Azure Cosmos DB for MongoDB per rispettare la terminologia usata in MongoDB.

Questo articolo illustra i diversi modi disponibili per creare una raccolta in Azure Cosmos DB for MongoDB. Se si usa un'API diversa, vedere gli articoli sull'API per NoSQL, l'API per Cassandra, l'API per Gremlin e l'API per Table per creare la raccolta.

Nota

Quando si creano le raccolte, assicurarsi di non creare due raccolte con lo stesso nome ma con una combinazione diversa di maiuscole/minuscole. Questo perché alcune parti della piattaforma Azure non fanno distinzione tra maiuscole e minuscole e ciò può comportare confusione/conflitti dei dati di telemetria e delle azioni sulle raccolte con tali nomi.

Creare usando il portale di Azure

  1. Accedere al portale di Azure.

  2. Creare un nuovo account Azure Cosmos DB o selezionarne uno esistente.

  3. Aprire il riquadro Esplora dati e selezionare Nuovo contenitore. Specificare quindi i dettagli seguenti:

    • Indicare se si intende creare un nuovo database o usarne uno esistente.
    • Immettere un ID contenitore.
    • Immettere una chiave di partizione.
    • Immettere una velocità effettiva da sottoporre a provisioning (ad esempio, 1000 UR).
    • Seleziona OK.

    Screenshot di Azure Cosmos DB per MongoDB, finestra di dialogo Aggiungi contenitore

Creare con .NET SDK

var bson = new BsonDocument
{
    { "customAction", "CreateCollection" },
    { "collection", "<CollectionName>" },//update CollectionName
    { "shardKey", "<ShardKeyName>" }, //update ShardKey
    { "offerThroughput", 400} //update Throughput
};
var shellCommand = new BsonDocumentCommand<BsonDocument>(bson);
// Create a collection with a partition key by using Mongo Driver:
db.RunCommand(shellCommand);

Se si verifica un'eccezione di timeout durante la creazione di una raccolta, eseguire un'operazione di lettura per verificare se la raccolta sia stata creata correttamente. L'operazione di lettura genera un'eccezione fino a quando l'operazione di creazione della raccolta non ha esito positivo. Per l'elenco dei codici di stato supportati dall'operazione di creazione, vedere l'articolo Codici di stato HTTP per Azure Cosmos DB.

Creare con l'interfaccia della riga di comando di Azure

Creare una raccolta per l'API Azure Cosmos DB for MongoDB con l'interfaccia della riga di comando di Azure. Per un elenco di tutti gli esempi dell'interfaccia della riga di comando di Azure in tutte le API di Azure Cosmos DB, vedere Esempi dell'interfaccia della riga di comando di Azure per Azure Cosmos DB.

Creare usando PowerShell

Creare una raccolta per l'API Azure Cosmos DB for MongoDB con PowerShell. Per un elenco di tutti gli esempi di PowerShell in tutte le API di Azure Cosmos DB, vedere Esempi di PowerShell

Creare una raccolta usando i modelli di Azure Resource Manager

Creare una raccolta per l'API Azure Cosmos DB for MongoDB con il modello di Resource Manager.

Passaggi successivi