Database.GetContainerQueryIterator Método

Definición

Espacio de nombres:

Microsoft.Azure.Cosmos

Ensamblado:

Microsoft.Azure.Cosmos.Client.dll

Paquete:

Microsoft.Azure.Cosmos v3.39.0

Sobrecargas

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	Este método crea una consulta para contenedores en una base de datos mediante una instrucción SQL con valores con parámetros. Devuelve un feedIterator. Para obtener más información sobre cómo preparar instrucciones SQL con valores con parámetros, consulte QueryDefinition sobrecarga.
GetContainerQueryIterator<T>(String, String, QueryRequestOptions)	Este método crea una consulta para contenedores en una base de datos mediante una instrucción SQL. Devuelve un feedIterator.

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)

Source:

Database.cs

Este método crea una consulta para contenedores en una base de datos mediante una instrucción SQL con valores con parámetros. Devuelve un feedIterator. Para obtener más información sobre cómo preparar instrucciones SQL con valores con parámetros, consulte QueryDefinition sobrecarga.

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)

Parámetros de tipo

T

Parámetros

queryDefinition

QueryDefinition

Definición de consulta de Cosmos SQL.

continuationToken

String

(Opcional) Token de continuación en el servicio Azure Cosmos DB.

requestOptions

QueryRequestOptions

(Opcional) Opciones de la solicitud de consulta de elemento.

Devoluciones

FeedIterator<T>

Iterador para recorrer los contenedores

Ejemplos

Esto crea el iterador de fuente de tipos para contenedores con queryDefinition como entrada.

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

Comentarios

https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started Consulte para obtener sintaxis y ejemplos.

ReadContainerAsync(ContainerRequestOptions, CancellationToken) se recomienda para la búsqueda de un único contenedor.

GetContainerQueryIterator<T>(String, String, QueryRequestOptions)

Source:

Database.cs

Este método crea una consulta para contenedores en una base de datos mediante una instrucción SQL. Devuelve 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)

Parámetros de tipo

T

Parámetros

queryText

String

Texto de la consulta de Cosmos SQL.

continuationToken

String

(Opcional) Token de continuación en el servicio Azure Cosmos DB.

requestOptions

QueryRequestOptions

(Opcional) Opciones de la solicitud de consulta de elemento.

Devoluciones

FeedIterator<T>

Iterador para recorrer los contenedores

Ejemplos

1. Esto crea el iterador de fuente de tipos para contenedores con queryText como entrada,

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. Esto crea el iterador de fuente de tipos para contenedores sin queryText, recuperando todos los contenedores.

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

Comentarios

https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started Consulte para obtener sintaxis y ejemplos.

ReadContainerAsync(ContainerRequestOptions, CancellationToken) se recomienda para la búsqueda de un único contenedor.