Usar ShopifyQL en Notebooks

ShopifyQL es el lenguaje de consulta de Shopify creado para el comercio. Los lenguajes de consulta se usan para solicitar y recuperar datos de las bases de datos. Puedes usarShopifyQLcon la aplicación Notebooks de Shopify para explorar la base de datos de tu negocio y recuperar los datos que te den una idea más detallada de tu negocio.

Para ver una lista completa de los valores y dimensiones disponibles que se pueden usar en las consultas de ShopifyQL Notebook, consulta elesquema de pedidosy elesquema de productos.

Resumen de ShopifyQL

Los datos de tu tienda se almacenan en tablas de bases de datos, estructuradas en columnas y filas definidas. Las columnas determinan el tipo de información que contienen, como las ventas, y las filas especifican el valor real del tipo de datos, como USD 2450 en ventas.

Para recuperar los datos en un formato comprensible, se debe enviar una consulta a la base de datos. Las consultas son preguntas que solicitan datos específicos como respuesta. Un lenguaje de consulta, como ShopifyQL, es una forma estandarizada de construir esa pregunta. Las consultas están formadas por palabras clave y sus parámetros correspondientes. La combinación de varias palabras clave con parámetros específicos crea la consulta. Después de crear la consulta, puedes ejecutarla y recibir una respuesta.

A continuación te mostramos un ejemplo de sintaxis de ShopifyQL, redactada a modo de consulta. Las palabras clave están en negrita y sus parámetros correspondientes están entre corchetes. Los parámetros que se muestran aquí son marcadores de posición:

FROM{table_name}SHOW{column1,column2,...}GROUPBY{dimension|date_group}WHERE{condition}SINCE{date_offset}UNTIL{date_offset}ORDERBY{column}DESCLIMIT{count}

Glosario de términos

Tabla de referencia de palabras clave

Estas son las palabras clave que puedes usar para escribir tu consulta:

Escribir consultas de ShopifyQL

Las consultas de ShopifyQL pueden requerir desde información útil sobre datos de alto nivel hasta información completa y detallada. Cada palabra clave tiene una función específica que sirve para crear tu consulta.

Conceptos básicos de ShopifyQL: FROM y SHOW

Para crear la consulta más sencilla con ShopifyQL, solo se requieren dos palabras clave: FROM y SHOW, escritas en ese orden. FROM, seguido de un parámetro de nombre de tabla, especifica qué tabla deseas consultar. SHOW, seguido de un parámetro de nombre de columna, especifica las columnas que deseas seleccionar.

Por ejemplo, puedes enumerar todas las identificaciones de productos y sus nombres correspondientes de la tabla de ventas escribiendo esta consulta:

FROMproductsSHOWproduct_id,product_title

Agrupar datos: GROUP BY

Para segmentar unamétricapordimensión, como ventas agrupadas por región, usa la palabra clave GROUP BY. La palabra clave GROUP BY se puede emparejar con cualquier parámetro de dimensión.

Por ejemplo, una consulta que agrupe los precios de envío por país y región de facturación se escribe del siguiente modo:

FROMordersSHOWshippingGROUPBYbilling_country,billing_region

A continuación incluimos otro ejemplo de consulta que usa unadimensión de tiempopara mostrar las ventas netas por mes:

FROMordersSHOWnet_salesGROUPBYmonth

La咨询前没有mostrara洛杉矶mes在洛杉矶que no hayas tenido ninguna venta. De modo que, si deseas formular una consulta que devuelva un período completo e ininterrumpido, usa el modificador ALL:

FROMordersSHOWnet_salesGROUPBYmonthALLSINCElast_yearUNTILtoday

Si usas el modificador ALL, también debes especificarSINCEyUNTIL. Ten en cuenta que el modificador ALL solo funciona con ladimensión de tiempo.

Dimensiones de tiempo

Estas son las dimensiones de tiempo que puedes usar para agrupar tus datos:

Filtrar datos: WHERE

La palabra劈开,te permite aplicar联合国filtro dimensional a toda una consulta de ShopifyQL.

Por ejemplo, si deseas obtener las ventas netas agrupadas por mes, pero solo de una región específica, tu consulta será:

FROMordersSHOWnet_salesGROUPBYmonthALLWHEREbilling_region='ohio'SINCElast_yearUNTILtoday

Como puedes ver en el ejemplo anterior, puedes filtrar el resultado establecido con el parámetro WHERE incluso si ese parámetro no está incluido en las palabras clave SHOW o GROUP BY. En este caso, las ventas netas se filtran en todos los meses para los pedidos con una dirección de facturación solo en Ohio, aunque billing_region no se incluya en el conjunto de resultados.

Operadores relacionales

La palabra clave WHERE usa operadores relacionales para filtrar los datos. En el ejemplo anterior, se usó "=" para especificar que la consulta se filtra en un valor determinado. Sin embargo, hay otros operadores disponibles:

Operadores lógicos

Para filtrar aún más la información, puedes agregar operadores lógicos a tu consulta. Los operadores lógicos de ShopifyQL son:

Puedes usar varios filtros con la palabra clave WHERE agregando operadores lógicos.

Siguiendo con el ejemplo de la consulta sobre el conjunto de datos, para obtener una agrupación por mes de las ventas netas para todos los pedidos en los que la dirección de facturación estaba en Ohio y se aplicó un descuento, la consulta es:

FROMordersSHOWnet_salesGROUPBYmonthALLWHEREbilling_region='ohio'ANDdiscounts>0SINCElast_yearUNTILtoday

Intervalo de fechas: SINCE y UNTIL

Si deseas filtrar tu consulta por una fecha o algún período de tiempo, puedes usar las palabras clave SINCE y UNTIL, y sus parámetros asociados. Estas palabras clave son únicas porque solo filtran períodos.

Por ejemplo, veamos una consulta para encontrar las ventas netas durante los últimos 12 meses en Canadá, hasta el día de hoy:

FROMordersSHOWnet_salesGROUPBYmonthALLWHEREbilling_country='Canada'SINCE-12mUNTILtoday

Operadores de intervalos de tiempo

Puedes filtrar por fechas específicas o por intervalos de fechas. Los operadores de intervalos de tiempo de ShopifyQL son los siguientes:

Filtrar por intervalos de fechas: DURING

La palabra clave DURING simplifica el filtrado de fechas para los intervalos de fechas. Puedes usar la palabra clave DURING para filtrar los resultados de la consulta por un período conocido, como un año calendario o un mes específico, o para los intervalos de fechas que tienen fechas diferentes cada año, como Black Friday Cyber Monday. Por ejemplo:

FROMordersSHOWsum(net_sales)GROUPBYdayALLDURINGbfcm2021

DURING acepta cualquiera de los siguientes operadores de intervalo de fechas con nombre:

Comparación entre los intervalos de fechas: COMPARE TO

La palabra clave COMPARE TO te permite comparar los datos en el intervalo de fechas en DURING y en el de COMPARE TO. Acepta cualquiera de los operadores de intervalo de fechas mencionados en la secciónDURING. El operador que usa COMPARE TO debe tener la misma duración que la que usó DURING. Por ejemplo,DURING this_week COMPARE TO last_weekes una combinación válida peroDURING this_week COMPARE TO last_monthno lo es.

El siguiente ejemplo compara las ventas netas durante Black Friday Cyber Monday 2022 con Black Friday Cyber Monday 2021.

FROMordersSHOWsum(net_sales)GROUPBYdayALLDURINGbfcm2022COMPARETObfcm2021

Ordenar datos: ORDER BY

Puedes especificar cómo deseas ordenar los datos que obtengas con tu consulta usando la palabra clave ORDER BY y sus parámetros: ASC para el orden ascendente y DESC para el orden descendente.

En la palabra clave ORDER BY puedes especificar cualquier métrica o dimensión que incluyas en tu consulta, incluidos varios campos.

Por ejemplo, esta consulta devuelve las ventas netas para cada país y región de facturación, ordenada por orden alfabético inverso por país de facturación y luego por región de facturación dentro de cada país.

FROMordersSHOWnet_salesGROUPBYbilling_country,billing_regionSINCE-1yUNTILtodayORDERBYbilling_country,billing_regionDESC

El orden en el que escribes tus métricas o dimensiones es importante. Si especificas varios valores para ORDER BY, la clasificación se aplicará a cada métrica o dimensión en el pedido dado.

Limitar

La palabra clave LIMIT te permite especificar cuántas filas devuelve la consulta. Esto resulta útil cuando simplemente deseas observar la apariencia de los datos en cada columna. También puedes combinarla con ORDER BY para crear listas superiores e inferiores.

埃斯特比如美国限制对位cre y秩序ar una lista con los diez productos más vendidos por cantidad de los últimos tres meses:

FROMproductsSHOWnet_product_quantityGROUPBYproduct_titleSINCE-3mUNTILtodayORDERBYnet_product_quantityDESCLIMIT10

Graficar las consultas: VISUALIZE y TYPE

La palabra clave VISUALIZE te permite escribir una consulta de ShopifyQL que muestre los datos en una visualización en forma de líneas o de barras.

La palabra劈开蒂波es opcional y听头红外acompañada de "línea" o "barra" para que la consulta devuelva una visualización a modo de gráfico de líneas o de gráfico de barras, respectivamente. Si TIPO no se incluye en la consulta, ShopifyQL decide automáticamente cuál es la visualización más adecuada. Si tu consulta no puede visualizarse como texto escrito, ShopifyQL mostrará datos tabulares.

Por ejemplo, puedes visualizar la tendencia que han experimentado tus ventas por mes en el último año con una línea de tendencia. La consulta siguiente dará como resultado un gráfico de serie cronológica con las ventas brutas por mes en el último año. Las ventas brutas se representarán en una sola línea, con el eje "X" etiquetado como mes y el "Y" etiquetado como ventas totales:

FROMordersVISUALIZEgross_salesTYPElineGROUPBYmonthALLSINCE-1yUNTILtoday

Operadores matemáticos

ShopifyQL permite realizar operaciones aritméticas con las métricas de tus datos. Los siguientes operadores matemáticos están disponibles:

Por ejemplo, la siguiente consulta calcula el valor de los pedidos en cada región durante el último año. Cuando usas operadores matemáticos con métricas, puedes emplear la palabra clave AS para asignar un nombre nuevo a la nueva métrica.

FROMordersSHOW(net_sales+returns)ASorder_value,orders,(net_sales+returns)/ordersASsales_per_orderGROUPBYbilling_regionSINCE-1yUNTILtoday

Funciones

Las funciones de ShopifyQL te permiten agregar columnas similares a las tablas dinámicas en Microsoft Excel. Esto significa combinarlas para crear un valor nuevo. Los siguientes operadores de funciones están disponibles en la versión actual de ShopifyQL:

Las funcionessum,min,maxyavgsolo se pueden usar con valores numéricos, mientras quecountpueden usarse para contabilizar diferentes casos de atributos dimensionales. No puedes usar campos agregados como argumentos en las funciones. Los campos agregados terminan en_sum,_counto_percent.

Por ejemplo, la siguiente consulta devolverá un error, ya que ventas_totales ya es un valor agregado:

FROMordersSHOWsum(total_sales)

A continuación te mostramos una consulta válida que mezcla campos agregados con funciones agregadas:

FROMordersSHOWaverage_order_value,sum(gross_sales)GROUPBYbilling_regionSINCE2021-01-01UNTIL2021-12-31

Esta consulta devuelve la suma agregada del valor promedio de los pedidos y la suma bruta de ventas como resultado de la funciónsum. Estas métricas se desglosan por región de facturación para todos los pedidos realizados en 2021.

Comentarios

Puedes usar comentarios para explicar secciones de declaraciones de ShopifyQL o para evitar la ejecución de una declaración ShopifyQL. Cualquier texto dentro de un comentario se ignorará durante el tiempo de ejecución.

Los comentarios de una sola línea comienzan--y terminan al final de la línea.

Los comentarios en varias líneas comienzan con/*y terminan con*/.

FROMordersSHOWaverage_order_value,sum(gross_sales)-- the line below has been commented out and will not run-- GROUP BY billing_regionWHEREbilling_country='United States'/* this line and the two lines below it have been commented out and will not run SINCE 2021-01-01 UNTIL 2021-12-31 */