Crie um contentor no Azure Cosmos DB para NoSQL usando .NET

Os contentores no Azure Cosmos DB armazenam conjuntos de itens. Antes de poder criar, consultar ou gerir itens, deve primeiro criar um contentor.

Nomeie um contentor

No Azure Cosmos DB, um contentor é análogo a uma tabela numa base de dados relacional. Quando você cria um contentor, o nome do contentor forma um segmento do URI usado para aceder ao recurso do contentor e a quaisquer itens subordinados.

Aqui ficam algumas regras rápidas ao nomear um contentor:

• Os nomes dos contentores não devem estar vazios.
• Os nomes dos contentores não podem ter mais de 256 caracteres.

Uma vez criado, o URI de um contentor está neste formato:

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>/colls/<container-name>

Criar um contêiner

Para criar um contentor, chame um dos seguintes métodos:

• CreateContainerAsync
• CreateContainerIfNotExistsAsync

Criar um contêiner de forma assíncrona

O exemplo seguinte cria um contentor de forma assíncrona:

// New instance of Container class referencing the server-side container
Container container1 = await database.CreateContainerAsync(
    id: "products-1",
    partitionKeyPath: "/category",
    throughput: 400
);

O Database.CreateContainerAsync método lança uma exceção se já existir uma base de dados com o mesmo nome.

Crie um contentor assíncrono, se ainda não existir

O exemplo seguinte cria um contentor de forma assíncrona apenas se este não existir já na conta:

// New instance of Container class referencing the server-side container
Container container2 = await database.CreateContainerIfNotExistsAsync(
    id: "products-2",
    partitionKeyPath: "/category",
    throughput: 400
);

O Database.CreateContainerIfNotExistsAsync método só cria um novo contentor se este ainda não existir. Esse método é útil para evitar erros se você executar o mesmo código várias vezes.

Analisar a resposta

Em todos os exemplos até agora, a resposta do pedido assíncrono foi convertida imediatamente para o tipo Container. Pode querer analisar metadados sobre a resposta, incluindo cabeçalhos e o código de estado HTTP. O verdadeiro tipo de retorno para os métodos Database.CreateContainerAsync e Database.CreateContainerIfNotExistsAsync é ContainerResponse.

O exemplo seguinte mostra o método Database.CreateContainerIfNotExistsAsync que retorna um ContainerResponse. Uma vez devolvida, podes analisar as propriedades da resposta e eventualmente obter o objeto Container subjacente:

// 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;

Próximos passos

Agora que criaste um contentor, usa o guia seguinte para criar os itens.