Database.GetContainerQueryIterator Méthode

Définition

Espace de noms:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paquet:

Microsoft.Azure.Cosmos v3.39.0

Surcharges

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	Cette méthode crée une requête pour les conteneurs sous une base de données à 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 Surcharge.
GetContainerQueryIterator<T>(String, String, QueryRequestOptions)	Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL. Il retourne un FeedIterator.

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)

Source:

Database.cs

Cette méthode crée une requête pour les conteneurs sous une base de données à 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 Surcharge.

public abstract Microsoft.Azure.Cosmos.FeedIterator<T> GetContainerQueryIterator<T> (Microsoft.Azure.Cosmos.QueryDefinition queryDefinition, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);

abstract member GetContainerQueryIterator : Microsoft.Azure.Cosmos.QueryDefinition * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>

Public MustOverride Function GetContainerQueryIterator(Of T) (queryDefinition As QueryDefinition, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator(Of T)

Paramètres de type

T

Paramètres

queryDefinition

QueryDefinition

Définition de requête Cosmos SQL.

continuationToken

String

(Facultatif) Jeton de continuation dans le service Azure Cosmos DB.

requestOptions

QueryRequestOptions

(Facultatif) Options de la demande de requête d’élément.

Retours

FeedIterator<T>

Itérateur pour parcourir les conteneurs

Exemples

Cela crée l’itérateur de flux de type pour les conteneurs avec queryDefinition comme entrée.

QueryDefinition queryDefinition = new QueryDefinition("SELECT * FROM c where c.status like @status");
    .WithParameter("@status", "start%");
using (FeedIterator<ContainerProperties> feedIterator = this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>(queryDefinition))
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<ContainerProperties> response = await feedIterator.ReadNextAsync();
        foreach (var container in response)
        {
            Console.WriteLine(container);
        }
    }
}

Remarques

Reportez-vous à pour obtenir la https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started syntaxe et des exemples.

ReadContainerAsync(ContainerRequestOptions, CancellationToken) est recommandé pour la recherche d’un conteneur unique.

GetContainerQueryIterator<T>(String, String, QueryRequestOptions)

Source:

Database.cs

Cette méthode crée une requête pour les conteneurs sous une base de données à l’aide d’une instruction SQL. Il retourne un FeedIterator.

public abstract Microsoft.Azure.Cosmos.FeedIterator<T> GetContainerQueryIterator<T> (string queryText = default, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);

abstract member GetContainerQueryIterator : string * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>

Public MustOverride Function GetContainerQueryIterator(Of T) (Optional queryText As String = Nothing, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator(Of T)

Paramètres de type

T

Paramètres

queryText

String

Texte de la requête Cosmos SQL.

continuationToken

String

(Facultatif) Jeton de continuation dans le service Azure Cosmos DB.

requestOptions

QueryRequestOptions

(Facultatif) Options de la demande de requête d’élément.

Retours

FeedIterator<T>

Itérateur pour parcourir les conteneurs

Exemples

1. Cela crée l’itérateur de flux de type pour les conteneurs avec queryText comme entrée,

string queryText = "SELECT * FROM c where c.status like 'start%'";
using (FeedIterator<ContainerProperties> feedIterator = this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>(queryText))
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<ContainerProperties> response = await feedIterator.ReadNextAsync();
        foreach (var container in response)
        {
            Console.WriteLine(container);
        }
    }
}

2. Cela crée l’itérateur de flux de type pour les conteneurs sans queryText, récupérant tous les conteneurs.

using (FeedIterator<ContainerProperties> feedIterator = this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>())
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<ContainerProperties> response = await feedIterator.ReadNextAsync();
        foreach (var container in response)
        {
           Console.WriteLine(container);
        }
    }
}

Remarques

Reportez-vous à pour obtenir la https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started syntaxe et des exemples.

ReadContainerAsync(ContainerRequestOptions, CancellationToken) est recommandé pour la recherche d’un conteneur unique.