CosmosClient.CreateDatabaseIfNotExistsAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
(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.
| StatusCode | Status de sucesso comumCodes para a operação CreateDatabaseIfNotExistsAsync |
|---|---|
| 201 | Criado – um novo banco de dados é criado. |
| 200 | OK- 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.
| StatusCode | Status de sucesso comumCodes para a operação CreateDatabaseIfNotExistsAsync |
|---|---|
| 201 | Criado – um novo banco de dados é criado. |
| 200 | OK - Isso significa que o banco de dados já existe. |
Aplica-se a
Azure SDK for .NET
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários