Database.GetContainerQueryIterator Methode

Definition

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paket:

Microsoft.Azure.Cosmos v3.39.0

Überlädt

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	Diese Methode erstellt eine Abfrage für Container unter einer Datenbank mithilfe einer SQL-Anweisung mit parametrisierten Werten. Er gibt einen FeedIterator zurück. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter QueryDefinition Überladung.
GetContainerQueryIterator<T>(String, String, QueryRequestOptions)	Diese Methode erstellt mithilfe einer SQL-Anweisung eine Abfrage für Container unter einer Datenbank. Er gibt einen FeedIterator zurück.

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)

Quelle:

Database.cs

Diese Methode erstellt eine Abfrage für Container unter einer Datenbank mithilfe einer SQL-Anweisung mit parametrisierten Werten. Er gibt einen FeedIterator zurück. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter QueryDefinition Überladung.

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)

Typparameter

T

Parameter

queryDefinition

QueryDefinition

Die Cosmos SQL-Abfragedefinition.

continuationToken

String

(Optional) Das Fortsetzungstoken im Azure Cosmos DB-Dienst.

requestOptions

QueryRequestOptions

(Optional) Die Optionen für die Elementabfrageanforderung.

Gibt zurück

FeedIterator<T>

Ein Iterator zum Durchlaufen der Container

Beispiele

Dadurch wird der Typfeediterator für Container mit queryDefinition als Eingabe erstellt.

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);
        }
    }
}

Hinweise

https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started Unter finden Sie Syntax und Beispiele.

ReadContainerAsync(ContainerRequestOptions, CancellationToken) wird für die Suche nach einzelnen Containern empfohlen.

GetContainerQueryIterator<T>(String, String, QueryRequestOptions)

Quelle:

Database.cs

Diese Methode erstellt mithilfe einer SQL-Anweisung eine Abfrage für Container unter einer Datenbank. Er gibt einen FeedIterator zurück.

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)

Typparameter

T

Parameter

queryText

String

Der Cosmos SQL-Abfragetext.

continuationToken

String

(Optional) Das Fortsetzungstoken im Azure Cosmos DB-Dienst.

requestOptions

QueryRequestOptions

(Optional) Die Optionen für die Elementabfrageanforderung.

Gibt zurück

FeedIterator<T>

Ein Iterator zum Durchlaufen der Container

Beispiele

1. Dadurch wird der Typfeediterator für Container mit queryText als Eingabe erstellt.

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. Dadurch wird der Typfeediterator für Container ohne queryText erstellt und alle Container abgerufen.

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);
        }
    }
}

Hinweise

https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started Unter finden Sie Syntax und Beispiele.

ReadContainerAsync(ContainerRequestOptions, CancellationToken) wird für die Suche nach einzelnen Containern empfohlen.