CosmosClient.CreateDatabaseIfNotExistsAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| CreateDatabaseIfNotExistsAsync(String, Nullable<Int32>, RequestOptions, CancellationToken) |
Compruebe si existe una base de datos y, si no es así, créela. Solo se usa el identificador de base de datos para comprobar si hay una base de datos existente. Otras propiedades de base de datos, como el rendimiento, no se validan y pueden ser diferentes y, a continuación, las propiedades pasadas. Una base de datos administra usuarios, permisos y un conjunto de contenedores. Cada cuenta de base de datos de Azure Cosmos DB es capaz de admitir varias bases de datos con nombre independientes, y la base de datos es el contenedor lógico de los datos. Cada base de datos consta de uno o varios contenedores, cada uno de los cuales, a su vez, contiene uno o varios documentos. Dado que las bases de datos son un recurso administrativo, se necesitará la clave maestra de servicio para acceder y completar correctamente cualquier acción mediante las API de usuario. |
| CreateDatabaseIfNotExistsAsync(String, ThroughputProperties, RequestOptions, CancellationToken) |
Compruebe si existe una base de datos y, si no es así, créela. Solo se usa el identificador de base de datos para comprobar si hay una base de datos existente. Otras propiedades de base de datos, como el rendimiento, no se validan y pueden ser diferentes y, a continuación, las propiedades pasadas. Una base de datos administra usuarios, permisos y un conjunto de contenedores. Cada cuenta de base de datos de Azure Cosmos DB es capaz de admitir varias bases de datos con nombre independientes, y la base de datos es el contenedor lógico de los datos. Cada base de datos consta de uno o varios contenedores, cada uno de los cuales, a su vez, contiene uno o varios documentos. Dado que las bases de datos son un recurso administrativo, se necesitará la clave maestra de servicio para acceder y completar correctamente cualquier acción mediante las API de usuario. |
CreateDatabaseIfNotExistsAsync(String, Nullable<Int32>, RequestOptions, CancellationToken)
Compruebe si existe una base de datos y, si no es así, créela. Solo se usa el identificador de base de datos para comprobar si hay una base de datos existente. Otras propiedades de base de datos, como el rendimiento, no se validan y pueden ser diferentes y, a continuación, las propiedades pasadas.
Una base de datos administra usuarios, permisos y un conjunto de contenedores. Cada cuenta de base de datos de Azure Cosmos DB es capaz de admitir varias bases de datos con nombre independientes, y la base de datos es el contenedor lógico de los datos.
Cada base de datos consta de uno o varios contenedores, cada uno de los cuales, a su vez, contiene uno o varios documentos. Dado que las bases de datos son un recurso administrativo, se necesitará la clave maestra de servicio para acceder y completar correctamente cualquier acción mediante las API de usuario.
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
Identificador de la base de datos.
(Opcional) Rendimiento aprovisionado para una base de datos en la medida de unidades de solicitud por segundo en el servicio Azure Cosmos DB.
- requestOptions
- RequestOptions
(Opcional) Conjunto de opciones adicionales que se pueden establecer.
- cancellationToken
- CancellationToken
(Opcional) CancellationToken que representa la cancelación de la solicitud.
Devoluciones
que Task contiene un DatabaseResponseDatabaseProperties objeto que contiene el registro de recursos.
| StatusCode | StatusCodes correcto común para la operación CreateDatabaseIfNotExistsAsync |
|---|---|
| 201 | Creado: se crea una nueva base de datos. |
| 200 | Correcto: esto significa que la base de datos ya existe. |
Comentarios
https://docs.microsoft.com/azure/cosmos-db/request-units para más información sobre el rendimiento de aprovisionamiento.
Se aplica a
CreateDatabaseIfNotExistsAsync(String, ThroughputProperties, RequestOptions, CancellationToken)
Compruebe si existe una base de datos y, si no es así, créela. Solo se usa el identificador de base de datos para comprobar si hay una base de datos existente. Otras propiedades de base de datos, como el rendimiento, no se validan y pueden ser diferentes y, a continuación, las propiedades pasadas.
Una base de datos administra usuarios, permisos y un conjunto de contenedores. Cada cuenta de base de datos de Azure Cosmos DB es capaz de admitir varias bases de datos con nombre independientes, y la base de datos es el contenedor lógico de los datos.
Cada base de datos consta de uno o varios contenedores, cada uno de los cuales, a su vez, contiene uno o varios documentos. Dado que las bases de datos son un recurso administrativo, se necesitará la clave maestra de servicio para acceder y completar correctamente cualquier acción mediante las API de usuario.
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
Identificador de la base de datos.
- throughputProperties
- ThroughputProperties
Rendimiento aprovisionado para una base de datos en la medida de unidades de solicitud por segundo en el servicio Azure Cosmos DB.
- requestOptions
- RequestOptions
(Opcional) Conjunto de opciones adicionales que se pueden establecer.
- cancellationToken
- CancellationToken
(Opcional) CancellationToken que representa la cancelación de la solicitud.
Devoluciones
que Task contiene un DatabaseResponseDatabaseProperties objeto que contiene el registro de recursos.
| StatusCode | StatusCodes correcto común para la operación CreateDatabaseIfNotExistsAsync |
|---|---|
| 201 | Creado: se crea una nueva base de datos. |
| 200 | Ok: esto significa que la base de datos ya existe. |
Se aplica a
Azure SDK for .NET
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de