Consultas de Datastore

Una consulta recupera entidades de Firestore en modo Datastore que cumplen con un conjunto específico de condiciones.

La consulta opera en entidades de un determinado tipo; puede especificar filtros en las propiedades, claves y principales de las entidades, y puede mostrar cero o más entidades como resultados. Una consulta también puede especificar órdenes de clasificación para secuenciar los resultados según los valores de sus propiedades. Los resultados incluyen todas las entidades que tienen al menos un valor por cada propiedad incluida en los filtros y órdenes de clasificación, y cuyos valores de propiedad cumplen con todos los criterios de filtro especificados. La consulta puede mostrar entidades completas, entidades proyectadas o solo claves de entidades.

Una consulta típica incluye lo siguiente:

Cuando se ejecuta una consulta, se recuperan todas las entidades del tipo indicado que cumplan con las condiciones de todos los filtros, en el orden especificado. Las consultas se ejecutan en modo de solo lectura.

Nota: Para conservar la memoria y mejorar el rendimiento, las consultas deben especificar, siempre que sea posible, un límite en la cantidad de resultados que se muestran.

Cada consulta calcula los resultados con uno o más índices, que contienen claves de entidad en una secuencia especificada por las propiedades del índice y, de forma opcional, los principales de la entidad. Los índices se actualizan de forma incremental con los cambios que la aplicación haga a sus entidades, de modo que los resultados correctos de todas las consultas estén disponibles sin necesidad de realizar cálculos adicionales.

El mecanismo de consultas basado en índices admite una amplia variedad de consultas y es apropiado para la mayoría de las aplicaciones. Sin embargo, este mecanismo no admite algunos tipos de consulta que son comunes en otras tecnologías de base de datos. En particular, el motor de consultas del modo Datastore no admite las operaciones de unión y agregación. Consulta Restricciones de las consultas a continuación para obtener más información sobre las limitaciones en las consultas en el modo Datastore.

Interfaz de consulta

A continuación, mostramos un ejemplo básico de una consulta en una base de datos en modo Datastore. La consulta recupera todas las tareas que aún no se realizaron, con prioridad mayor o igual que 4, y las clasifica en orden descendente según la prioridad:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Filter = Filter.And(Filter.Equal("done", false),
            Filter.GreaterThanOrEqual("priority", 4)),
        Order = { { "priority", PropertyOrder.Types.Direction.Descending } }
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").
    	Filter("Done =", false).
    	Filter("Priority >=", 4).
    	Order("-Priority")

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query = Query.newEntityQueryBuilder()
        .setKind("Task")
        .setFilter(CompositeFilter.and(
            PropertyFilter.eq("done", false), PropertyFilter.ge("priority", 4)))
        .setOrderBy(OrderBy.desc("priority"))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery('Task')
      .filter('done', '=', false)
      .filter('priority', '>=', 4)
      .order('priority', {
        descending: true,
      });

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->filter('done', '=', false)
        ->filter('priority', '>=', 4)
        ->order('priority', Query::ORDER_DESCENDING);

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.add_filter('done', '=', False)
    query.add_filter('priority', '>=', 4)
    query.order = ['-priority']

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .where("done", "=", false)
                     .where("priority", ">=", 4)
                     .order("priority", :desc)

GQL


    SELECT * FROM Task
    WHERE done = FALSE AND priority >= 4
    ORDER BY priority DESC

    

Usa estos modelos para ejecutar consultas.

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task");
    DatastoreQueryResults tasks = _db.RunQuery(query);

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

it := client.Run(ctx, query)
    for {
    	var task Task
    	_, err := it.Next(&task)
    	if err == iterator.Done {
    		break
    	}
    	if err != nil {
    		log.Fatalf("Error fetching next task: %v", err)
    	}
    	fmt.Printf("Task %q, Priority %d\n", task.Description, task.Priority)
    }

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

QueryResults<Entity> tasks = datastore.run(query);

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const [tasks] = await datastore.runQuery(query);
    console.log('Tasks:');
    tasks.forEach(task => console.log(task));

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$result = $datastore->runQuery($query);

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query()
    results = list(query.fetch())

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

tasks = datastore.run query

GQL

No aplicable

Estructura de la consulta

Una consulta puede especificar un tipo de entidad, cero o más filtros, y cero o más órdenes de clasificación.

Filtros

El conjunto de filtros de una consulta limita las propiedades, claves y los principales de las entidades que se recuperarán.

Filtros de propiedades

Un filtro de propiedad especifica lo siguiente:

  • El nombre de una propiedad
  • Un operador de comparación
  • El valor de una propiedad

En este ejemplo, se muestran entidades Task marcadas como no realizadas:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Filter = Filter.Equal("done", false)
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").Filter("Done =", false)

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query =
        Query.newEntityQueryBuilder().setKind("Task").setFilter(PropertyFilter.eq("done", false))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore.createQuery('Task').filter('done', '=', false);

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->filter('done', '=', false);

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.add_filter('done', '=', False)

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .where("done", "=", false)

GQL


    SELECT * FROM Task WHERE done = FALSE

    

La aplicación debe proporcionar el valor de la propiedad. No se puede referir a otras propiedades ni calcularse según estas. Una entidad cumple con la condición del filtro si tiene una propiedad con el nombre dado, cuyo valor coincide con el valor especificado en el filtro, de acuerdo con la descripción del operador de comparación. Si la propiedad del nombre dado tiene un arreglo de valores, la entidad cumple con la condición del filtro siempre que alguno de esos valores coincida con el valor especificado en el filtro, de acuerdo con la descripción del operador de comparación.

El operador de comparación puede ser cualquiera de las siguientes opciones:

Operador Significado
EQUAL Igual que
LESS_THAN Menor que
LESS_THAN_OR_EQUAL Menor que o igual que
GREATER_THAN Mayor que
GREATER_THAN_OR_EQUAL Superior o igual a

Filtros compuestos

Un filtro compuesto consta de más de un filtro de propiedad. En este ejemplo se muestran entidades Task marcadas como no realizadas y con una prioridad 4:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Filter = Filter.And(Filter.Equal("done", false),
            Filter.Equal("priority", 4)),
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").Filter("Done =", false).Filter("Priority =", 4)

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query = Query.newEntityQueryBuilder()
        .setKind("Task")
        .setFilter(
            CompositeFilter.and(PropertyFilter.eq("done", false), PropertyFilter.eq("priority", 4)))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery('Task')
      .filter('done', '=', false)
      .filter('priority', '=', 4);

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->filter('done', '=', false)
        ->filter('priority', '=', 4);

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.add_filter('done', '=', False)
    query.add_filter('priority', '=', 4)

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .where("done", "=", false)
                     .where("priority", "=", 4)

GQL


    SELECT * FROM Task WHERE done = FALSE AND priority = 4

    

Firestore en modo Datastore admite de forma nativa la combinación de filtros con solo el operador AND.

Filtros de clave

Para filtrar el valor de la clave de una entidad, usa la propiedad especial __key__:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Filter = Filter.GreaterThan("__key__", _keyFactory.CreateKey("aTask"))
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

key := datastore.NameKey("Task", "someTask", nil)
    query := datastore.NewQuery("Task").Filter("__key__ >", key)

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query = Query.newEntityQueryBuilder()
        .setKind("Task")
        .setFilter(PropertyFilter.gt("__key__", keyFactory.newKey("someTask")))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery('Task')
      .filter('__key__', '>', datastore.key(['Task', 'someTask']));

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->filter('__key__', '>', $datastore->key('Task', 'someTask'));

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    first_key = client.key('Task', 'first_task')
    # key_filter(key, op) translates to add_filter('__key__', op, key).
    query.key_filter(first_key, '>')

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .where("__key__", ">", datastore.key("Task", "someTask"))

GQL


    SELECT * FROM Task WHERE __key__ > KEY(Task, 'someTask')

    

Cuando se usa un comparador de desigualdad, se aplican los siguientes criterios para clasificar las claves, en orden:

  1. Ruta del principal
  2. Tipo de entidad
  3. Identificador (nombre de clave o ID numérico)

Los elementos de la ruta principal se comparan de manera similar: por tipo (string) y, luego, por nombre de clave o ID numérico. Los tipos y los nombres de clave son strings y se ordenan por valor de byte. Los ID numéricos son números enteros ordenados numéricamente. Si varias entidades que tienen el mismo principal y tipo usan una combinación de ID numéricos y strings de nombre de clave, las entidades que tienen ID numéricos anteceden a las que tienen nombres de clave.

Las consultas de claves usan índices, al igual que las consultas de propiedades, y requieren índices personalizados en los mismos casos, salvo algunas excepciones: los filtros de desigualdad o un orden de clasificación ascendente con clave no necesitan un índice personalizado, pero si es necesario cuando se usa un orden de clasificación descendente con clave. Al igual que con todas las consultas, el servidor de desarrollo crea entradas adecuadas en el archivo de configuración de índices cuando una consulta que requiere un índice personalizado se usa en el entorno de desarrollo.

Órdenes de clasificación

Un orden de clasificación de consulta especifica:

  • Un nombre de propiedad
  • Una dirección de clasificación (ascendente o descendente). El orden de clasificación predeterminado es ascendente

En este ejemplo, se clasifican entidades Task por tiempo de creación en orden ascendente:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Order = { { "created", PropertyOrder.Types.Direction.Ascending } }
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").Order("created")

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query =
        Query.newEntityQueryBuilder().setKind("Task").setOrderBy(OrderBy.asc("created")).build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore.createQuery('Task').order('created');

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->order('created');

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.order = ['created']

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .order("created", :asc)

GQL


    SELECT * FROM Task ORDER BY created ASC

    

En este ejemplo, se clasifican entidades Task por tiempo de creación en orden descendente

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Order = { { "created", PropertyOrder.Types.Direction.Descending } }
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").Order("-created")

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query =
        Query.newEntityQueryBuilder().setKind("Task").setOrderBy(OrderBy.desc("created")).build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore.createQuery('Task').order('created', {
      descending: true,
    });

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->order('created', Query::ORDER_DESCENDING);

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.order = ['-created']

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .order("created", :desc)

GQL


    SELECT * FROM Task ORDER BY created DESC

    

Si una consulta incluye varios órdenes de clasificación, estos se aplican en la secuencia especificada. En el siguiente ejemplo, primero se clasifica por prioridad descendente y, luego, por tiempo de creación ascendente:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Order = { { "priority", PropertyOrder.Types.Direction.Descending },
            { "created", PropertyOrder.Types.Direction.Ascending } }
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").Order("-priority").Order("created")

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query = Query.newEntityQueryBuilder()
        .setKind("Task")
        .setOrderBy(OrderBy.desc("priority"), OrderBy.asc("created"))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery('Task')
      .order('priority', {
        descending: true,
      })
      .order('created');

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->order('priority', Query::ORDER_DESCENDING)
        ->order('created');

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.order = [
        '-priority',
        'created'
    ]

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .order("priority", :desc)
                     .order("created", :asc)

GQL


    SELECT * FROM Task ORDER BY priority DESC, created ASC

    

Si no se especifica ningún orden de clasificación, los resultados se muestran en el orden en que se recuperaron en el modo Datastore.

Nota: Debido a la forma en que el modo Datastore ejecuta las consultas, si una consulta especifica filtros de desigualdad en una propiedad y órdenes de clasificación en otras propiedades, la propiedad que se use en los filtros de desigualdad deberá ordenarse antes que las demás propiedades.

Tipos especiales de consultas

Hay algunos tipos específicos de consultas que merecen una mención especial:

Consultas principales

Una consulta principal limita sus resultados a la entidad especificada y a sus secundarios. En este ejemplo se muestran todas las entidades Task cuyo principal es una entidad TaskList especificada:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Filter = Filter.HasAncestor(_db.CreateKeyFactory("TaskList")
            .CreateKey(keyName))
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

ancestor := datastore.NameKey("TaskList", "default", nil)
    query := datastore.NewQuery("Task").Ancestor(ancestor)

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query = Query.newEntityQueryBuilder()
        .setKind("Task")
        .setFilter(PropertyFilter.hasAncestor(
            datastore.newKeyFactory().setKind("TaskList").newKey("default")))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const ancestorKey = datastore.key(['TaskList', 'default']);

    const query = datastore.createQuery('Task').hasAncestor(ancestorKey);

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$ancestorKey = $datastore->key('TaskList', 'default');
    $query = $datastore->query()
        ->kind('Task')
        ->hasAncestor($ancestorKey);

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

# Query filters are omitted in this example as any ancestor queries with a
    # non-key filter require a composite index.
    ancestor = client.key('TaskList', 'default')
    query = client.query(kind='Task', ancestor=ancestor)

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

ancestor_key = datastore.key "TaskList", "default"

    query = datastore.query("Task")
                     .ancestor(ancestor_key)

GQL


    SELECT * FROM Task WHERE __key__ HAS ANCESTOR KEY(TaskList, 'default')

    

Consultas sin categoría

Cuando una consulta no especifica la categoría ni el principal, se muestran todas las entidades de una aplicación del modo Datastore. Estas consultas sin categoría no pueden incluir filtros ni órdenes de clasificación para los valores de las propiedades. No obstante, pueden filtrar las claves de entidad y usar filtros principales. Para usar los filtros de clave, se puede especificar __key__ como el nombre de la propiedad:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query()
    {
        Filter = Filter.GreaterThan("__key__",
            _keyFactory.CreateKey("aTask"))
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("").Filter("__key__ >", lastSeenKey)

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query =
        Query.newEntityQueryBuilder().setFilter(PropertyFilter.gt("__key__", lastSeenKey)).build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery()
      .filter('__key__', '>', lastSeenKey)
      .limit(1);

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->filter('__key__', '>', $lastSeenKey);

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query()
    query.key_filter(last_seen_key, '>')

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = Google::Cloud::Datastore::Query.new
    query.where "__key__", ">", last_seen_key

GQL


    SELECT * WHERE __key__ > KEY(Task, 'someTask')

    

Consultas de proyección

La mayoría de las consultas muestran entidades completas como resultado. Sin embargo, solo unas pocas propiedades de la entidad son relevantes para las aplicaciones. Las consultas de proyección te permiten hacer consultas solo de las propiedades específicas de una entidad que necesitas, con una latencia y un costo más bajos que mostrar la entidad completa.

Para las consultas de proyección, se deben indexar las propiedades especificadas.

Consultas de solo clave

Una consulta de solo clave (que es un tipo de consulta de proyección) muestra solo las claves de las entidades de los resultados, en lugar de las entidades en sí, con una latencia y un costo más bajos que mostrar las entidades completas.

A menudo, es más rentable hacer primero consultas de solo clave y, luego, recuperar un subconjunto de entidades de los resultados, en lugar de ejecutar una consulta general que puede recuperar más entidades que las que necesitas.

Sigue estos modelos para crear consultas de solo clave:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Projection = { "__key__" }
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").KeysOnly()

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Key> query = Query.newKeyQueryBuilder().setKind("Task").build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery()
      .select('__key__')
      .limit(1);

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->keysOnly();

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query()
    query.keys_only()

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .select("__key__")

GQL


    SELECT __key__ FROM Task

    

Una consulta de solo clave es una operación pequeña y cuenta como una sola lectura de entidad.

Proyecciones

Las consultas de proyección son similares a las consultas de SQL que tienen la siguiente forma.

SELECT priority, percent_complete FROM Task
    

Puedes usar todas las características de filtrado y ordenamiento disponibles para las consultas de entidad estándar, pero debes tener en cuenta estas limitaciones.

La consulta SQL de ejemplo muestra resultados abreviados con solo las propiedades especificadas, priority y percent_complete, con valores propagados; todas las demás propiedades no se propagan. A continuación, se explica cómo puedes plantear esto como una consulta de proyección:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Projection = { "priority", "percent_complete" }
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").Project("Priority", "PercentComplete")

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<ProjectionEntity> query = Query.newProjectionEntityQueryBuilder()
        .setKind("Task")
        .setProjection("priority", "percent_complete")
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery('Task')
      .select(['priority', 'percent_complete']);

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->projection(['priority', 'percent_complete']);

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.projection = ['priority', 'percent_complete']

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .select("priority", "percent_complete")

GQL


    SELECT priority, percent_complete FROM Task

    

Sigue estos modelos para ejecutar la consulta de proyección:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Projection = { "priority", "percent_complete" }
    };
    List<long> priorities = new List<long>();
    List<double> percentCompletes = new List<double>();
    foreach (var entity in _db.RunQuery(query).Entities)
    {
        priorities.Add((long)entity["priority"]);
        percentCompletes.Add((double)entity["percent_complete"]);
    }

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

var priorities []int
    var percents []float64
    it := client.Run(ctx, query)
    for {
    	var task Task
    	if _, err := it.Next(&task); err == iterator.Done {
    		break
    	} else if err != nil {
    		log.Fatal(err)
    	}
    	priorities = append(priorities, task.Priority)
    	percents = append(percents, task.PercentComplete)
    }

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

List<Long> priorities = new LinkedList<>();
    List<Double> percentCompletes = new LinkedList<>();
    QueryResults<ProjectionEntity> tasks = datastore.run(query);
    while (tasks.hasNext()) {
      ProjectionEntity task = tasks.next();
      priorities.add(task.getLong("priority"));
      percentCompletes.add(task.getDouble("percent_complete"));
    }

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

async function runProjectionQuery() {
      const priorities = [];
      const percentCompletes = [];
      const [tasks] = await datastore.runQuery(query);
      tasks.forEach(task => {
        priorities.push(task.priority);
        percentCompletes.push(task.percent_complete);
      });

      return {
        priorities: priorities,
        percentCompletes: percentCompletes,
      };
    }

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$priorities = array();
    $percentCompletes = array();
    $result = $datastore->runQuery($query);
    /* @var Entity $task */
    foreach ($result as $task) {
        $priorities[] = $task['priority'];
        $percentCompletes[] = $task['percent_complete'];
    }

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

priorities = []
    percent_completes = []

    for task in query.fetch():
        priorities.append(task['priority'])
        percent_completes.append(task['percent_complete'])

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

priorities = []
    percent_completes = []
    datastore.run(query).each do |task|
      priorities << task["priority"]
      percent_completes << task["percent_complete"]
    end

GQL

No aplicable

Una consulta de proyección que no utiliza la cláusula distinct on es una operación pequeña y cuenta como una sola lectura de entidad.

Agrupación

Las consultas de proyección pueden usar la cláusula distinct on a fin de asegurarse de que solo se muestre el primer resultado de cada combinación de valores para las propiedades especificadas. Esto mostrará solo el primer resultado para las entidades que tengan los mismos valores que las propiedades que se proyectan.

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Projection = { "category", "priority" },
        DistinctOn = { "category" },
        Order = {
            { "category", PropertyOrder.Types.Direction.Ascending},
            {"priority", PropertyOrder.Types.Direction.Ascending }
        }
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").
    	Project("Priority", "Category").
    	DistinctOn("Category").
    	Order("Category").Order("Priority")

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<ProjectionEntity> query = Query.newProjectionEntityQueryBuilder()
        .setKind("Task")
        .setProjection("category", "priority")
        .setDistinctOn("category")
        .setOrderBy(OrderBy.asc("category"), OrderBy.asc("priority"))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery('Task')
      .groupBy('category')
      .order('category')
      .order('priority');

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->order('category')
        ->order('priority')
        ->projection(['category', 'priority'])
        ->distinctOn('category');

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.distinct_on = ['category']
    query.order = ['category', 'priority']

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .select("category", "priority")
                     .distinct_on("category")
                     .order("category")
                     .order("priority")

GQL


    SELECT DISTINCT ON (category) category, priority FROM Task
    ORDER BY category, priority

    

Arreglos de valores

Ten en cuenta lo siguiente cuando tus consultas incluyan propiedades con arreglos de valores.

Las propiedades con arreglos de valores pueden comportarse de maneras sorprendentes

Debido a la forma en que se indexan, las entidades con múltiples valores para la misma propiedad pueden interactuar con los filtros de consulta y los órdenes de clasificación de maneras inesperadas y sorprendentes.

Si una consulta tiene varios filtros de desigualdad para una propiedad determinada, una entidad coincidirá con la consulta solo si al menos uno de sus valores individuales para esa propiedad satisface todos los filtros. Por ejemplo, si una entidad del tipo Task tiene los valores fun y programming para la propiedad tag, no coincidirá con la consulta:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Filter = Filter.And(Filter.GreaterThan("tag", "learn"),
            Filter.LessThan("tag", "math"))
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").
    	Filter("Tag >", "learn").
    	Filter("Tag <", "math")

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query = Query.newEntityQueryBuilder()
        .setKind("Task")
        .setFilter(CompositeFilter.and(
            PropertyFilter.gt("tag", "learn"), PropertyFilter.lt("tag", "math")))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery('Task')
      .filter('tag', '>', 'learn')
      .filter('tag', '<', 'math');

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->filter('tag', '>', 'learn')
        ->filter('tag', '<', 'math');

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.add_filter('tag', '>', 'learn')
    query.add_filter('tag', '<', 'math')

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .where("tag", ">", "learn")
                     .where("tag", "<", "math")

GQL


    SELECT * FROM Task WHERE tag > 'learn' AND tag < 'math'

    

Cada uno de los valores tag de la entidad cumple con la condición de uno de los filtros, pero ningún valor individual cumple con ambos. Esto no se aplica a los filtros de igualdad. Por ejemplo, la misma entidad cumple con la siguiente consulta:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Filter = Filter.And(Filter.Equal("tag", "fun"),
            Filter.Equal("tag", "programming"))
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").
    	Filter("Tag =", "fun").
    	Filter("Tag =", "programming")

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query = Query.newEntityQueryBuilder()
        .setKind("Task")
        .setFilter(CompositeFilter.and(
            PropertyFilter.eq("tag", "fun"), PropertyFilter.eq("tag", "programming")))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore
      .createQuery('Task')
      .filter('tag', '=', 'fun')
      .filter('tag', '=', 'programming');

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->filter('tag', '=', 'fun')
        ->filter('tag', '=', 'programming');

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query(kind='Task')
    query.add_filter('tag', '=', 'fun')
    query.add_filter('tag', '=', 'programming')

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .where("tag", "=", "fun")
                     .where("tag", "=", "programming")

GQL


    SELECT * FROM Task WHERE tag = 'fun' AND tag = 'programming'

    

aunque ninguno de los valores tag individuales de la entidad cumple con ambas condiciones del filtro.

Del mismo modo, el orden de clasificación para las propiedades con valores múltiples es inusual. Debido a que estas propiedades aparecen una vez en el índice por cada valor único, el primer valor que se observa en el índice determina el orden de clasificación de una entidad.

Si no se usa una propiedad con valores múltiples en ningún filtro, puede suceder lo siguiente:

  • Si la propiedad ordena los resultados de la consulta de forma ascendente, se usará el valor más pequeño de la propiedad para el ordenamiento.
  • Si la propiedad ordena los resultados de la consulta de forma descendente, se usará el valor más elevado de la propiedad para el ordenamiento.
  • Otros valores no afectan el orden de clasificación ni la cantidad de valores.

Esto tiene la consecuencia inusual de que la entidad con los valores de propiedad 1 y 9 antecede a una entidad con los valores 4, 5, 6 y 7, en orden ascendente y descendente.

Si se usa una propiedad con valores múltiples en un filtro de igualdad, se ignora cualquier orden de clasificación sobre esa propiedad.

Si se usa una propiedad con valores múltiples en un filtro de desigualdad, puede suceder lo siguiente:

  • Si la propiedad ordena los resultados de la consulta de forma ascendente, se usará el valor más pequeño que satisfaga todos los filtros de desigualdad de la consulta para el ordenamiento.
  • Si la propiedad ordena los resultados de la consulta de forma descendente, se usará el valor más elevado que satisfaga todos los filtros de desigualdad de la consulta para el ordenamiento.

Ten en cuenta que si un conjunto de filtros de desigualdad en una propiedad se traduce como un filtro de igualdad, por ejemplo

WHERE tags >= 'math' AND tags <= 'math'
    

se ignorará cualquier orden de clasificación sobre esa propiedad, ya que los filtros evalúan lo mismo que el filtro de igualdad

WHERE tags = 'math'
    

Proyecciones y propiedades con arreglos de valores

La proyección de una propiedad con valores de arreglos no propagará todos los valores para esa propiedad. En su lugar, se mostrará una entidad independiente para cada combinación única de valores proyectados que coincidan con la consulta. Por ejemplo, supongamos que tienes una entidad del tipo Task con dos propiedades con valores múltiples, tags y collaborators:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Entity task = new Entity()
    {
        Key = _db.CreateKeyFactory("Task").CreateKey("sampleTask"),
        ["collaborators"] = new ArrayValue() { Values = { "alice", "bob" } },
        ["tags"] = new ArrayValue() { Values = { "fun", "programming" } }
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

type Task struct {
    	Tags          []string
    	Collaborators []string
    }
    task := &Task{
    	Tags:          []string{"fun", "programming"},
    	Collaborators: []string{"alice", "bob"},
    }

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Entity task = Entity.newBuilder(taskKey)
        .set("tags", "fun", "programming")
        .set("collaborators", ListValue.of("alice", "bob"))
        .build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const task = {
      tags: ['fun', 'programming'],
      collaborators: ['alice', 'bob'],
    };

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$task = $datastore->entity(
        $key,
        [
            'tags' => ['fun', 'programming'],
            'collaborators' => ['alice', 'bob']
        ]
    );

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

task = datastore.Entity(key)
    task.update({
        'tags': [
            'fun',
            'programming'
        ],
        'collaborators': [
            'alice',
            'bob'
        ]
    })

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

task = datastore.entity "Task", "sampleTask" do |t|
      t["tags"] = ["fun", "programming"]
      t["collaborators"] = ["alice", "bob"]
    end

GQL

No aplicable

Luego, la consulta de proyección

SELECT tags, collaborators FROM Task WHERE collaborators < 'charlie'
    

mostrará cuatro entidades con las combinaciones de valores siguientes:

tags = 'fun', collaborators = 'alice'
tags = 'fun', collaborators = 'bob'
tags = 'programming', collaborators = 'alice'
tags = 'programming', collaborators = 'bob'

Cursores, límites y compensaciones

Puedes especificar un límite para tu consulta a fin de controlar la cantidad máximo de resultados que se muestran en un lote. En el siguiente ejemplo, se muestran un máximo de cinco entidades Task:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Limit = 5,
    };

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

query := datastore.NewQuery("Task").Limit(5)

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

Query<Entity> query = Query.newEntityQueryBuilder().setKind("Task").setLimit(5).build();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

const query = datastore.createQuery('Task').limit(5);

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

$query = $datastore->query()
        ->kind('Task')
        ->limit(5);

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

query = client.query()
    tasks = list(query.fetch(limit=5))

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

query = datastore.query("Task")
                     .limit(5)

GQL


    SELECT * FROM Task LIMIT 5

    

Los cursores de consulta permiten que una aplicación recupere los resultados de una consulta en los lotes convenientes sin la sobrecarga de una compensación de consulta. Después de realizar una operación de recuperación, la aplicación puede obtener un cursor, que es una string de bytes opaca que marca la posición en el índice del último resultado recuperado. La aplicación puede guardar esta string (por ejemplo, en la base de datos en modo Datastore, en caché o incorporada en una página web como un parámetro GET o POST HTTP codificado en base-64) y, luego, puede usar el cursor como el punto de partida para una operación de recuperación posterior y obtener el próximo lote de resultados desde el punto en que finalizó la recuperación anterior. En una recuperación, también se puede especificar un cursor de fin, para limitar la extensión del conjunto de resultados mostrados.

En el siguiente ejemplo se explica el uso de los cursores para paginación:

C#

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

Query query = new Query("Task")
    {
        Limit = pageSize,
    };
    if (!string.IsNullOrEmpty(pageCursor))
        query.StartCursor = ByteString.FromBase64(pageCursor);

    return _db.RunQuery(query).EndCursor?.ToBase64();

Go

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

const pageSize = 5
    query := datastore.NewQuery("Tasks").Limit(pageSize)
    if cursorStr != "" {
    	cursor, err := datastore.DecodeCursor(cursorStr)
    	if err != nil {
    		log.Fatalf("Bad cursor %q: %v", cursorStr, err)
    	}
    	query = query.Start(cursor)
    }

    // Read the tasks.
    var tasks []Task
    var task Task
    it := client.Run(ctx, query)
    _, err := it.Next(&task)
    for err == nil {
    	tasks = append(tasks, task)
    	_, err = it.Next(&task)
    }
    if err != iterator.Done {
    	log.Fatalf("Failed fetching results: %v", err)
    }

    // Get the cursor for the next page of results.
    nextCursor, err := it.Cursor()

Java

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

EntityQuery.Builder queryBuilder = Query.newEntityQueryBuilder().setKind("Task")
        .setLimit(pageSize);
    if (pageCursor != null) {
      queryBuilder.setStartCursor(pageCursor);
    }
    QueryResults<Entity> tasks = datastore.run(queryBuilder.build());
    while (tasks.hasNext()) {
      Entity task = tasks.next();
      // do something with the task
    }
    Cursor nextPageCursor = tasks.getCursorAfter();

Node.js

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

// By default, google-cloud-node will automatically paginate through all of
    // the results that match a query. However, this sample implements manual
    // pagination using limits and cursor tokens.
    async function runPageQuery(pageCursor) {
      let query = datastore.createQuery('Task').limit(pageSize);

      if (pageCursor) {
        query = query.start(pageCursor);
      }
      const results = await datastore.runQuery(query);
      const entities = results[0];
      const info = results[1];

      if (info.moreResults !== Datastore.NO_MORE_RESULTS) {
        // If there are more results to retrieve, the end cursor is
        // automatically set on `info`. To get this value directly, access
        // the `endCursor` property.
        const results = await runPageQuery(info.endCursor);

        // Concatenate entities
        results[0] = entities.concat(results[0]);
        return results;
      }

      return [entities, info];
    }

PHP

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

/**
     * Fetch a query cursor.
     *
     * @param DatastoreClient $datastore
     * @param string $pageSize
     * @param string $pageCursor
     * @return array
     */
    function cursor_paging(DatastoreClient $datastore, $pageSize, $pageCursor = '')
    {
        $query = $datastore->query()
            ->kind('Task')
            ->limit($pageSize)
            ->start($pageCursor);
        $result = $datastore->runQuery($query);
        $nextPageCursor = '';
        $entities = [];
        /* @var Entity $entity */
        foreach ($result as $entity) {
            $nextPageCursor = $entity->cursor();
            $entities[] = $entity;
        }
        return array(
            'nextPageCursor' => $nextPageCursor,
            'entities' => $entities
        );
    }

Python

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.


    def get_one_page_of_tasks(cursor=None):
        query = client.query(kind='Task')
        query_iter = query.fetch(start_cursor=cursor, limit=5)
        page = next(query_iter.pages)

        tasks = list(page)
        next_cursor = query_iter.next_page_token

        return tasks, next_cursor

Ruby

Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

page_size = 2
    query = datastore.query("Task")
                     .limit(page_size)
    tasks = datastore.run query

    page_cursor = tasks.cursor

    query = datastore.query("Task")
                     .limit(page_size)
                     .start(page_cursor)

GQL

No aplicable

Aunque las bases de datos del modo Datastore admiten compensaciones de números enteros, debes evitar usarlos. En su lugar, usa cursores. Usar una compensación solo evita que se muestren las entidades omitidas en la aplicación, pero se siguen recuperando internamente. Las entidades omitidas afectan a la latencia de la consulta y tu aplicación se factura por las operaciones de lectura necesarias para recuperarlas. Usar cursores en lugar de compensaciones te permite evitar todos estos costos.

Limitaciones de los cursores

Los cursores están sujetos a las siguientes limitaciones:

  • Un cursor solo puede usarse en el mismo proyecto que realizó la consulta original y solo continúa en la misma consulta. No se puede recuperar resultados con un cursor sin configurar la misma consulta desde la que fue generado.
  • Si se modifica alguno de los siguientes elementos, se puede seguir usando un cursor para las recuperaciones posteriores.
  • cursor de inicio
  • cursor de fin
  • compensación
  • límite
  • Si se modifica alguno de los siguientes elementos, no se puede usar un cursor para las recuperaciones posteriores.
  • proyección
  • tipo
  • principal
  • filtro
  • distinto en
  • orden de clasificación

    Hay una excepción si el orden de clasificación final de la consulta original se hizo según __key__. En ese caso, puedes usar el cursor en una consulta inversa, que es la consulta original con cada orden de clasificación invertido. La consulta inversa puede modificar el cursor de inicio, el cursor de fin, la compensación y el límite.

  • Los cursores no siempre se comportan de la forma esperada con una consulta que usa un filtro de desigualdad o un orden de clasificación que depende de una propiedad con valores múltiples. La lógica de deduplicación para esas propiedades con valores múltiples no persiste entre las recuperaciones, lo que, posiblemente, hará que el mismo resultado se muestre más de una vez.
  • Las nuevas versiones del modo Datastore pueden modificar los detalles de implementación interna, lo que invalida los cursores que dependen de ellas. Si una aplicación intenta usar un cursor que ya no es válido, Firestore en modo Datastore generará una excepción.
  • Actualizaciones de datos y cursores

    El cursor representa la ubicación en la lista de resultados después de que se muestra el último resultado. Un cursor no es una posición relativa en la lista (no es una compensación); es un marcador al que puede saltar una base de datos del modo Datastore cuando se inicia un análisis de índice para obtener resultados. Si los resultados de una consulta cambian entre distintos usos de un cursor, la consulta observará solo los cambios que se producen en los resultados después del cursor. Si aparece un resultado nuevo antes de la posición del cursor para la consulta, este no se mostrará cuando se recuperen los resultados que le siguen al cursor. De igual modo, si una entidad ya no es un resultado para una consulta, pero ha aparecido antes del cursor, los resultados que aparecen después del cursor no se modifican. Si el último resultado que se muestra se quita del conjunto de resultados, el cursor podrá ubicar el resultado siguiente de todas maneras.

    Cuando se recuperan los resultados de la consulta, puedes usar un cursor de inicio y un cursor de fin para mostrar un grupo continuo de resultados. Cuando se usa un cursor de inicio y de fin para recuperar los resultados, no hay garantía de que el tamaño de los resultados será el mismo que cuando se generaron los cursores. Se pueden agregar o borrar entidades desde la base de datos entre el momento en que los cursores se generan y en que se utilizan en una consulta.

    Restricciones para las consultas

    La naturaleza del mecanismo de consulta de índice impone ciertas restricciones sobre lo que puede hacer una consulta. Las consultas del modo Datastore no admiten coincidencias de substring, coincidencias que no distinguen entre mayúsculas y minúsculas, o la denominada búsqueda en el texto completo. Los operadores NOT, OR y != no son compatibles de forma nativa, pero algunas bibliotecas cliente pueden agregar compatibilidad en el modo Datastore. Además:

    Las entidades que carecen de una propiedad nombrada en la consulta se ignoran

    No es necesario que las entidades del mismo tipo tengan las mismas propiedades. Para poder devolverse como resultado de una consulta, una entidad debe poseer un valor (posiblemente nulo) para cada propiedad nombrada en los filtros de consulta y los órdenes de clasificación. De lo contrario, se omitirá la entidad de los índices usados para ejecutar la consulta y, en consecuencia, no se incluirá en los resultados de la consulta.

    Filtrar propiedades sin índice no muestra resultados

    Una consulta no puede hallar valores de propiedad que no están indexados y tampoco puede ordenar las propiedades. Consulta la sección Propiedades no indexadas para obtener un análisis detallado sobre el tema.

    Los filtros de desigualdad se limitan a una propiedad como máximo

    Para no tener que explorar el índice completo, el mecanismo de consulta confía en que todos los resultados potenciales de una consulta sean adyacentes entre sí en el índice. Para satisfacer esta limitación, una sola consulta no puede usar comparaciones de desigualdad (LESS_THAN, LESS_THAN_OR_EQUAL, GREATER_THAN, GREATER_THAN_OR_EQUAL) que usen más de una propiedad en todos los filtros. Por ejemplo, la siguiente consulta es válida porque los dos filtros de desigualdad se aplican a la misma propiedad:

    C#

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

    Query query = new Query("Task")
        {
            Filter = Filter.And(Filter.GreaterThan("created", _startDate),
                Filter.LessThan("created", _endDate))
        };

    Go

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

    query := datastore.NewQuery("Task").
        	Filter("Created >", time.Date(1990, 1, 1, 0, 0, 0, 0, time.UTC)).
        	Filter("Created <", time.Date(2000, 1, 1, 0, 0, 0, 0, time.UTC))

    Java

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

    Query<Entity> query = Query.newEntityQueryBuilder()
            .setKind("Task")
            .setFilter(CompositeFilter.and(
                PropertyFilter.gt("created", startDate), PropertyFilter.lt("created", endDate)))
            .build();

    Node.js

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

    const query = datastore
          .createQuery('Task')
          .filter('created', '>', new Date('1990-01-01T00:00:00z'))
          .filter('created', '<', new Date('2000-12-31T23:59:59z'));

    PHP

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

    $query = $datastore->query()
            ->kind('Task')
            ->filter('created', '>', new DateTime('1990-01-01T00:00:00z'))
            ->filter('created', '<', new DateTime('2000-12-31T23:59:59z'));

    Python

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

    start_date = datetime.datetime(1990, 1, 1)
        end_date = datetime.datetime(2000, 1, 1)
        query = client.query(kind='Task')
        query.add_filter(
            'created', '>', start_date)
        query.add_filter(
            'created', '<', end_date)

    Ruby

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

    query = datastore.query("Task")
                         .where("created", ">=", Time.utc(1990, 1, 1))
                         .where("created", "<", Time.utc(2000, 1, 1))

    GQL

    
        SELECT * FROM Task
        WHERE created > DATETIME('1990-01-01T00:00:00z')
          AND created < DATETIME('2000-12-31T23:59:59z')
    
        

    Sin embargo, esta consulta no es válida porque usa filtros de desigualdad en dos propiedades diferentes:

    C#

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

    Query query = new Query("Task")
        {
            Filter = Filter.And(Filter.GreaterThan("created", _startDate),
                Filter.GreaterThan("priority", 3))
        };

    Go

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

    query := datastore.NewQuery("Task").
        	Filter("Created >", time.Date(1990, 1, 1, 0, 0, 0, 0, time.UTC)).
        	Filter("Priority >", 3)

    Java

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

    Query<Entity> query = Query.newEntityQueryBuilder()
            .setKind("Task")
            .setFilter(CompositeFilter.and(
                PropertyFilter.gt("created", startDate), PropertyFilter.gt("priority", 3)))
            .build();

    Node.js

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

    const query = datastore
          .createQuery('Task')
          .filter('priority', '>', 3)
          .filter('created', '>', new Date('1990-01-01T00:00:00z'));

    PHP

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

    $query = $datastore->query()
            ->kind('Task')
            ->filter('priority', '>', 3)
            ->filter('created', '>', new DateTime('1990-01-01T00:00:00z'));

    Python

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

    start_date = datetime.datetime(1990, 1, 1)
        query = client.query(kind='Task')
        query.add_filter(
            'created', '>', start_date)
        query.add_filter(
            'priority', '>', 3)

    Ruby

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

    query = datastore.query("Task")
                         .where("created", ">=", Time.utc(1990, 1, 1))
                         .where("priority", ">", 3)

    GQL

    
        # Invalid query!
        SELECT * FROM Task
        WHERE created > DATETIME('1990-01-01T00:00:00z')
        AND priority > 3
    
        

    Recuerda que una consulta puede combinar filtros de igualdad (EQUAL) para propiedades diferentes, junto con uno o más filtros de desigualdad en una sola propiedad. Por lo tanto, la siguiente consulta es válida:

    C#

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

    Query query = new Query("Task")
        {
            Filter = Filter.And(Filter.Equal("priority", 4),
                Filter.GreaterThan("created", _startDate),
                Filter.LessThan("created", _endDate))
        };

    Go

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

    query := datastore.NewQuery("Task").
        	Filter("Priority =", 4).
        	Filter("Done =", false).
        	Filter("Created >", time.Date(1990, 1, 1, 0, 0, 0, 0, time.UTC)).
        	Filter("Created <", time.Date(2000, 1, 1, 0, 0, 0, 0, time.UTC))

    Java

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

    Query<Entity> query = Query.newEntityQueryBuilder()
            .setKind("Task")
            .setFilter(CompositeFilter.and(PropertyFilter.eq("priority", 4),
                PropertyFilter.gt("created", startDate), PropertyFilter.lt("created", endDate)))
            .build();

    Node.js

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

    const query = datastore
          .createQuery('Task')
          .filter('priority', '=', 4)
          .filter('done', '=', false)
          .filter('created', '>', new Date('1990-01-01T00:00:00z'))
          .filter('created', '<', new Date('2000-12-31T23:59:59z'));

    PHP

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

    $query = $datastore->query()
            ->kind('Task')
            ->filter('priority', '=', 4)
            ->filter('done', '=', false)
            ->filter('created', '>', new DateTime('1990-01-01T00:00:00z'))
            ->filter('created', '<', new DateTime('2000-12-31T23:59:59z'));

    Python

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

    start_date = datetime.datetime(1990, 1, 1)
        end_date = datetime.datetime(2000, 12, 31, 23, 59, 59)
        query = client.query(kind='Task')
        query.add_filter('priority', '=', 4)
        query.add_filter('done', '=', False)
        query.add_filter(
            'created', '>', start_date)
        query.add_filter(
            'created', '<', end_date)

    Ruby

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

    query = datastore.query("Task")
                         .where("done", "=", false)
                         .where("priority", "=", 4)
                         .where("created", ">=", Time.utc(1990, 1, 1))
                         .where("created", "<", Time.utc(2000, 1, 1))

    GQL

    
        SELECT * FROM Task
        WHERE priority = 4
          AND done = FALSE
          AND created > DATETIME('1990-01-01T00:00:00z')
          AND created < DATETIME('2000-12-31T23:59:59z')
    
        

    Cuando no se especifica un orden de clasificación, no se define el orden de los resultados de la consulta

    Cuando una consulta no especifica un orden de clasificación, los resultados se muestran en el orden en que se recuperan. Este orden puede cambiar a medida que evolucione la implementación del modo Datastore (o si cambian los índices de un proyecto). Por lo tanto, si tu aplicación requiere que los resultados de la consulta estén en un orden en particular, asegúrate de especificar este orden de clasificación en la consulta.

    Se ignoran los órdenes de clasificación en las propiedades con filtros de igualdad

    Las consultas que incluyen un filtro de igualdad para una propiedad determinada ignoran cualquier orden de clasificación especificado para esa propiedad. Esta es una optimización simple que permite evitar el procesamiento innecesario de propiedades con valores únicos, ya que todos los resultados tienen el mismo valor para la propiedad y, por ende, no se necesita mayor clasificación. Sin embargo, las propiedades con valores múltiples pueden tener valores adicionales, además del que coincide con el filtro de igualdad. Dado que este caso práctico es inusual y aplicar el orden de clasificación sería costoso y requeriría índices adicionales, el planificador de consultas del modo Datastore simplemente ignora el orden de clasificación, incluso en el caso de valores múltiples. Esto puede hacer que los resultados de la consulta se muestren en un orden diferente al que parece implicar el orden de clasificación.

    Primero deben clasificarse las propiedades que se usan en los filtros de desigualdad

    Para recuperar todos los resultados que coinciden con un filtro de desigualdad, una consulta analiza el índice hasta encontrar la primera fila que coincide con el filtro y, luego, explora hacia delante hasta que encuentra una fila que no coincide. Para que las filas consecutivas abarquen el conjunto completo de resultados, deben estar ordenadas por la propiedad que se usa en el filtro de desigualdad antes de cualquier otra propiedad. Por lo tanto, si una consulta especifica uno o más filtros de desigualdad junto con uno o más órdenes de clasificación, el primer orden de clasificación debe referirse a la misma propiedad nombrada en los filtros de desigualdad. La siguiente es una consulta válida:

    C#

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

    Query query = new Query("Task")
        {
            Filter = Filter.GreaterThan("priority", 3),
            Order = { { "priority", PropertyOrder.Types.Direction.Ascending},
                {"created", PropertyOrder.Types.Direction.Ascending } }
        };

    Go

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

    query := datastore.NewQuery("Task").
        	Filter("Priority >", 3).
        	Order("Priority").
        	Order("Created")

    Java

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

    Query<Entity> query = Query.newEntityQueryBuilder()
            .setKind("Task")
            .setFilter(PropertyFilter.gt("priority", 3))
            .setOrderBy(OrderBy.asc("priority"), OrderBy.asc("created"))
            .build();

    Node.js

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

    const query = datastore
          .createQuery('Task')
          .filter('priority', '>', 3)
          .order('priority')
          .order('created');

    PHP

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

    $query = $datastore->query()
            ->kind('Task')
            ->filter('priority', '>', 3)
            ->order('priority')
            ->order('created');

    Python

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

    query = client.query(kind='Task')
        query.add_filter('priority', '>', 3)
        query.order = ['priority', 'created']

    Ruby

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

    query = datastore.query("Task")
                         .where("priority", ">", 3)
                         .order("priority")
                         .order("created")

    GQL

    
        SELECT * FROM Task WHERE priority > 3 ORDER BY priority, created
    
        

    Esta consulta no es válida, ya que no ordena sobre la base de la propiedad que se usa en el filtro de desigualdad:

    C#

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

    Query query = new Query("Task")
        {
            Filter = Filter.GreaterThan("priority", 3),
            Order = { { "created", PropertyOrder.Types.Direction.Ascending } }
        };

    Go

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

    query := datastore.NewQuery("Task").
        	Filter("Priority >", 3).
        	Order("Created")

    Java

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

    Query<Entity> query = Query.newEntityQueryBuilder()
            .setKind("Task")
            .setFilter(PropertyFilter.gt("priority", 3))
            .setOrderBy(OrderBy.asc("created"))
            .build();

    Node.js

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

    const query = datastore
          .createQuery('Task')
          .filter('priority', '>', 3)
          .order('created');

    PHP

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

    $query = $datastore->query()
            ->kind('Task')
            ->filter('priority', '>', 3)
            ->order('created');

    Python

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

    query = client.query(kind='Task')
        query.add_filter('priority', '>', 3)
        query.order = ['created']

    Ruby

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

    query = datastore.query("Task")
                         .where("priority", ">", 3)
                         .order("created")

    GQL

    
        # Invalid query!
        SELECT * FROM Task WHERE priority > 3 ORDER BY created
    
        

    Del mismo modo, esta consulta no es válida porque la propiedad que se usa en el filtro de desigualdad no es la primera que se usa para ordenar:

    C#

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para C#.

    Query query = new Query("Task")
        {
            Filter = Filter.GreaterThan("priority", 3),
            Order = { {"created", PropertyOrder.Types.Direction.Ascending },
                { "priority", PropertyOrder.Types.Direction.Ascending} }
        };

    Go

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Go.

    query := datastore.NewQuery("Task").
        	Filter("Priority >", 3).
        	Order("Created").
        	Order("Priority")

    Java

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Java.

    Query<Entity> query = Query.newEntityQueryBuilder()
            .setKind("Task")
            .setFilter(PropertyFilter.gt("priority", 3))
            .setOrderBy(OrderBy.asc("created"), OrderBy.asc("priority"))
            .build();

    Node.js

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Node.js.

    const query = datastore
          .createQuery('Task')
          .filter('priority', '>', 3)
          .order('created')
          .order('priority');

    PHP

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para PHP.

    $query = $datastore->query()
            ->kind('Task')
            ->filter('priority', '>', 3)
            ->order('created')
            ->order('priority');

    Python

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Python.

    query = client.query(kind='Task')
        query.add_filter('priority', '>', 3)
        query.order = ['created', 'priority']

    Ruby

    Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud Datastore, consulta la página acerca de las bibliotecas cliente de Cloud Datastore. Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Datastore para Ruby.

    query = datastore.query("Task")
                         .where("priority", ">", 3)
                         .order("created")
                         .order("priority")

    GQL

    
        # Invalid query!
        SELECT * FROM Task WHERE priority > 3 ORDER BY created, priority
    
        

    Límites de las proyecciones

    Las consultas de proyección están sujetas a las limitaciones siguientes:

    • Solo se pueden proyectar propiedades indexadas

      No se admite la proyección para las strings que tienen más de 1,500 bytes, los arreglos de bytes que tienen más de 1,500 elementos y otras propiedades marcadas explícitamente como no indexadas.

    • No se puede proyectar la misma propiedad más de una vez

    • No se pueden proyectar las propiedades mencionadas en un filtro de igualdad

      Por ejemplo,

      SELECT tag FROM Task WHERE priority = 1
          

      Es una consulta válida, ya que la propiedad proyectada no se usa en el filtro de igualdad. También lo es la siguiente consulta:

      SELECT tag FROM Task WHERE tag > 'fun`
          

      No es un filtro de igualdad. Sin embargo, la siguiente consulta no es válida:

      SELECT tag FROM Task WHERE tag = 'fun`
          

      La propiedad proyectada se usa en un filtro de igualdad.

    • Los resultados que muestra una consulta de proyección no se deben volver a guardar en la base de datos del modo Datastore.

      Dado que la consulta muestra resultados que solo están parcialmente propagados, estos no deben volver a escribirse en la base de datos del modo Datastore.

    • Las consultas de proyección convierten las marcas de tiempo en números enteros

      En los resultados de una consulta de proyección, el modo Datastore convierte los valores de las marcas de tiempo en valores de números enteros expresados en microsegundos.

    Qué sigue