WHERE, ORDER BY, LIMIT

Una consulta sin filtro es un informe de «todas las cuentas»: útil una vez, peligroso siempre. En una org con 400.000 cuentas, traerlas todas para quedarte con cinco es lento y además choca con los governor limits. La regla de oro de SOQL es pedirle a la base de datos exactamente lo que necesitas, y nada más.

La nutria: El paralelo de Admin

Yo lo hacía todo en el informe: añadía filtros (Sector igual a Tecnología, Fecha de cierre este trimestre), escribía la lógica de filtros (1 AND (2 OR 3)), ordenaba por una columna y, si quería, limitaba las filas con «Mostrar las 10 primeras». SOQL tiene exactamente esas cuatro piezas: WHERE, AND/OR con paréntesis, ORDER BY y LIMIT.

WHERE: los filtros

List<Opportunity> opps = [
    SELECT Id, Name, Amount, StageName
    FROM Opportunity
    WHERE Amount > 50000 AND IsClosed = false
];

• Los textos van entre comillas simples, igual que en Apex. Las comillas dobles no existen en SOQL.
• En SOQL se compara con un solo =, no con ==. Es un lenguaje distinto dentro de los corchetes.
• Las comparaciones de texto no distinguen mayúsculas: Industry = 'retail' encuentra 'Retail'. Como el buscador de un informe.
• En LIKE, % significa «cualquier cosa». '%Global%' es «contiene Global».

AND, OR y paréntesis: la lógica de filtros

Cuando un informe tiene tres filtros, Salesforce los une con AND por defecto; si quieres otra cosa, escribes la lógica de filtros: 1 AND (2 OR 3). En SOQL escribes esa misma lógica con las condiciones en lugar de los números. Y los paréntesis importan igual que allí: sin ellos, AND se evalúa antes que OR, como la multiplicación antes que la suma en el Módulo 1.

// Lógica de filtros del informe: 1 AND (2 OR 3)
[SELECT Id, Name FROM Account
 WHERE BillingCountry = 'Spain'
   AND (Industry = 'Retail' OR Industry = 'Banking')]

// Lo mismo, más corto, con IN
[SELECT Id, Name FROM Account
 WHERE BillingCountry = 'Spain'
   AND Industry IN ('Retail', 'Banking')]

Fechas relativas: las mismas que en tus informes

En un informe eliges «Fecha de cierre: este trimestre» o «Últimos 30 días» sin escribir ninguna fecha. SOQL tiene los mismos atajos, llamados literales de fecha. Se escriben sin comillas y se recalculan cada vez que se ejecuta la consulta, así que tu código sigue funcionando el año que viene.

ORDER BY y LIMIT

// Las 10 oportunidades abiertas más grandes de este trimestre
List<Opportunity> top10 = [
    SELECT Id, Name, Amount
    FROM Opportunity
    WHERE IsClosed = false AND CloseDate = THIS_QUARTER
    ORDER BY Amount DESC NULLS LAST
    LIMIT 10
];

Pruébalo: la consulta y su resultado, en vivo

Abajo tienes una org de Sales Cloud en miniatura (cinco cuentas con sus contactos) y una consulta que puedes montar por piezas. Cambia el filtro, el orden, el límite y los campos: la consulta se reescribe sola y la tabla de resultados se recalcula al instante. Es el Developer Console sin salir de aquí.

• ASC ordena de menor a mayor (o A→Z) y es el valor por defecto; DESC, al revés.
• NULLS LAST manda los vacíos al final. Sin él, en orden ascendente los null salen primero.
• Sin ORDER BY, el orden no está garantizado: no des por hecho que llegan por fecha de creación.