CosmosClient.GetDatabaseQueryStreamIterator Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
GetDatabaseQueryStreamIterator(QueryDefinition, String, QueryRequestOptions) |
Cette méthode crée une requête pour les bases de données sous un compte Cosmos DB à l’aide d’une instruction SQL avec des valeurs paramétrables. Il retourne un FeedIterator. Pour plus d’informations sur la préparation d’instructions SQL avec des valeurs paramétrables, consultez QueryDefinition. |
GetDatabaseQueryStreamIterator(String, String, QueryRequestOptions) |
Cette méthode crée une requête pour les bases de données sous un compte Cosmos DB à l’aide d’une instruction SQL. Il retourne un FeedIterator. |
GetDatabaseQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)
- Source:
- CosmosClient.cs
Cette méthode crée une requête pour les bases de données sous un compte Cosmos DB à l’aide d’une instruction SQL avec des valeurs paramétrables. Il retourne un FeedIterator. Pour plus d’informations sur la préparation d’instructions SQL avec des valeurs paramétrables, consultez QueryDefinition.
public virtual Microsoft.Azure.Cosmos.FeedIterator GetDatabaseQueryStreamIterator (Microsoft.Azure.Cosmos.QueryDefinition queryDefinition, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);
abstract member GetDatabaseQueryStreamIterator : Microsoft.Azure.Cosmos.QueryDefinition * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator
override this.GetDatabaseQueryStreamIterator : Microsoft.Azure.Cosmos.QueryDefinition * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator
Public Overridable Function GetDatabaseQueryStreamIterator (queryDefinition As QueryDefinition, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator
Paramètres
- queryDefinition
- QueryDefinition
Définition de requête cosmos SQL.
- continuationToken
- String
Jeton de continuation dans le service Azure Cosmos DB.
- requestOptions
- QueryRequestOptions
(Facultatif) Options de la requête.
Retours
Itérateur pour parcourir les bases de données
Exemples
Exemple sur la façon de vider complètement les résultats de la requête.
QueryDefinition queryDefinition = new QueryDefinition("select * From c where c._rid = @rid")
.WithParameter("@rid", "TheRidValue");
using (FeedIterator feedIterator = this.CosmosClient.GetDatabaseQueryStreamIterator(
queryDefinition)
{
while (feedIterator.HasMoreResults)
{
// Stream iterator returns a response with status for errors
using(ResponseMessage response = await feedIterator.ReadNextAsync())
{
// Handle failure scenario.
if(!response.IsSuccessStatusCode)
{
// Log the response.Diagnostics and handle the error
}
}
}
}
Remarques
Reportez-vous à pour obtenir la https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started syntaxe et des exemples.
ReadStreamAsync(RequestOptions, CancellationToken) est recommandé pour la recherche d’une base de données unique.
S’applique à
GetDatabaseQueryStreamIterator(String, String, QueryRequestOptions)
- Source:
- CosmosClient.cs
Cette méthode crée une requête pour les bases de données sous un compte Cosmos DB à l’aide d’une instruction SQL. Il retourne un FeedIterator.
public virtual Microsoft.Azure.Cosmos.FeedIterator GetDatabaseQueryStreamIterator (string queryText = default, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);
abstract member GetDatabaseQueryStreamIterator : string * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator
override this.GetDatabaseQueryStreamIterator : string * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator
Public Overridable Function GetDatabaseQueryStreamIterator (Optional queryText As String = Nothing, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator
Paramètres
- queryText
- String
Texte de la requête cosmos SQL.
- continuationToken
- String
Jeton de continuation dans le service Azure Cosmos DB.
- requestOptions
- QueryRequestOptions
(Facultatif) Options de la requête.
Retours
Itérateur pour parcourir les bases de données
Exemples
Exemple sur la façon de vider complètement les résultats de la requête.
using (FeedIterator feedIterator = this.CosmosClient.GetDatabaseQueryStreamIterator(
("select * From c where c._rid = 'TheRidValue'")
{
while (feedIterator.HasMoreResults)
{
// Stream iterator returns a response with status for errors
using(ResponseMessage response = await feedIterator.ReadNextAsync())
{
// Handle failure scenario.
if(!response.IsSuccessStatusCode)
{
// Log the response.Diagnostics and handle the error
}
}
}
}
Remarques
Reportez-vous à pour obtenir la https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started syntaxe et des exemples.
ReadStreamAsync(RequestOptions, CancellationToken) est recommandé pour la recherche d’une base de données unique.
S’applique à
Azure SDK for .NET