Compartilhar via


CosmosClient.CreateDatabaseIfNotExistsAsync Método

Definição

Sobrecargas

CreateDatabaseIfNotExistsAsync(String, Nullable<Int32>, RequestOptions, CancellationToken)

Verifique se existe um banco de dados e, se não existir, crie-o. Somente a ID do banco de dados é usada para verificar se há um banco de dados existente. Outras propriedades de banco de dados, como taxa de transferência, não são validadas e podem ser diferentes e, em seguida, as propriedades passadas.

Um banco de dados gerencia usuários, permissões e um conjunto de contêineres. Cada conta de banco de dados do Azure Cosmos DB é capaz de dar suporte a vários bancos de dados nomeados independentes, sendo o banco de dados o contêiner lógico para dados.

Cada Banco de Dados consiste em um ou mais contêineres, cada um dos quais, por sua vez, contém um ou mais documentos. Como os bancos de dados são um recurso administrativo, a Chave Mestra de Serviço será necessária para acessar e concluir com êxito qualquer ação usando as APIs de Usuário.

CreateDatabaseIfNotExistsAsync(String, ThroughputProperties, RequestOptions, CancellationToken)

Verifique se existe um banco de dados e, se não existir, crie-o. Somente a ID do banco de dados é usada para verificar se há um banco de dados existente. Outras propriedades de banco de dados, como taxa de transferência, não são validadas e podem ser diferentes e, em seguida, as propriedades passadas.

Um banco de dados gerencia usuários, permissões e um conjunto de contêineres. Cada conta de banco de dados do Azure Cosmos DB é capaz de dar suporte a vários bancos de dados nomeados independentes, sendo o banco de dados o contêiner lógico para dados.

Cada Banco de Dados consiste em um ou mais contêineres, cada um dos quais, por sua vez, contém um ou mais documentos. Como os bancos de dados são um recurso administrativo, a Chave Mestra de Serviço será necessária para acessar e concluir com êxito qualquer ação usando as APIs de Usuário.

CreateDatabaseIfNotExistsAsync(String, Nullable<Int32>, RequestOptions, CancellationToken)

Verifique se existe um banco de dados e, se não existir, crie-o. Somente a ID do banco de dados é usada para verificar se há um banco de dados existente. Outras propriedades de banco de dados, como taxa de transferência, não são validadas e podem ser diferentes e, em seguida, as propriedades passadas.

Um banco de dados gerencia usuários, permissões e um conjunto de contêineres. Cada conta de banco de dados do Azure Cosmos DB é capaz de dar suporte a vários bancos de dados nomeados independentes, sendo o banco de dados o contêiner lógico para dados.

Cada Banco de Dados consiste em um ou mais contêineres, cada um dos quais, por sua vez, contém um ou mais documentos. Como os bancos de dados são um recurso administrativo, a Chave Mestra de Serviço será necessária para acessar e concluir com êxito qualquer ação usando as APIs de Usuário.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse> CreateDatabaseIfNotExistsAsync (string id, int? throughput = default, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse>
override this.CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse>
Public Overridable Function CreateDatabaseIfNotExistsAsync (id As String, Optional throughput As Nullable(Of Integer) = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DatabaseResponse)

Parâmetros

id
String

A ID do banco de dados.

throughput
Nullable<Int32>

(Opcional) A taxa de transferência provisionada para um banco de dados na medição de Unidades de Solicitação por segundo no serviço do Azure Cosmos DB.

requestOptions
RequestOptions

(Opcional) Um conjunto de opções adicionais que podem ser definidas.

cancellationToken
CancellationToken

(Opcional) CancellationToken que representa o cancelamento da solicitação.

Retornos

Um Task que contém um DatabaseResponse que encapsula um DatabaseProperties que contém o registro de recurso.

StatusCodeStatus de sucesso comumCodes para a operação CreateDatabaseIfNotExistsAsync
201Criado – um novo banco de dados é criado.
200OK- Isso significa que o banco de dados já existe.

Comentários

https://docs.microsoft.com/azure/cosmos-db/request-units para obter detalhes sobre a taxa de transferência de provisionamento.

Aplica-se a

CreateDatabaseIfNotExistsAsync(String, ThroughputProperties, RequestOptions, CancellationToken)

Verifique se existe um banco de dados e, se não existir, crie-o. Somente a ID do banco de dados é usada para verificar se há um banco de dados existente. Outras propriedades de banco de dados, como taxa de transferência, não são validadas e podem ser diferentes e, em seguida, as propriedades passadas.

Um banco de dados gerencia usuários, permissões e um conjunto de contêineres. Cada conta de banco de dados do Azure Cosmos DB é capaz de dar suporte a vários bancos de dados nomeados independentes, sendo o banco de dados o contêiner lógico para dados.

Cada Banco de Dados consiste em um ou mais contêineres, cada um dos quais, por sua vez, contém um ou mais documentos. Como os bancos de dados são um recurso administrativo, a Chave Mestra de Serviço será necessária para acessar e concluir com êxito qualquer ação usando as APIs de Usuário.

public virtual System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse> CreateDatabaseIfNotExistsAsync (string id, Microsoft.Azure.Cosmos.ThroughputProperties throughputProperties, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateDatabaseIfNotExistsAsync : string * Microsoft.Azure.Cosmos.ThroughputProperties * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse>
override this.CreateDatabaseIfNotExistsAsync : string * Microsoft.Azure.Cosmos.ThroughputProperties * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse>
Public Overridable Function CreateDatabaseIfNotExistsAsync (id As String, throughputProperties As ThroughputProperties, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DatabaseResponse)

Parâmetros

id
String

A ID do banco de dados.

throughputProperties
ThroughputProperties

A taxa de transferência provisionada para um banco de dados na medição de Unidades de Solicitação por segundo no serviço do Azure Cosmos DB.

requestOptions
RequestOptions

(Opcional) Um conjunto de opções adicionais que podem ser definidas.

cancellationToken
CancellationToken

(Opcional) CancellationToken que representa o cancelamento da solicitação.

Retornos

Um Task que contém um DatabaseResponse que encapsula um DatabaseProperties que contém o registro de recurso.

StatusCodeStatus de sucesso comumCodes para a operação CreateDatabaseIfNotExistsAsync
201Criado – um novo banco de dados é criado.
200OK - Isso significa que o banco de dados já existe.

Aplica-se a