ShopifyQL:n käyttäminen Notebooksissa

ShopifyQL on Shopifyn kaupankäyntiä varten kehitetty kyselykieli. Kyselykieltä käytetään tietojen pyytämiseen ja hakemiseen tietokannoista. ShopifyQL-kyselykieltä ja Shopifyn Notebooks-sovellusta käyttäen voit tutkia oman yrityksesi tietokantaa ja noutaa tietoja, jotka antavat sinulle entistä yksityiskohtaisempia tietoja liiketoiminnastasi.

Täydellinen luettelo ShopifyQL Notebook -kyselyissä käytettävissä olevista arvoista ja mitoista on Orders-skeemassa ja Products-skeemassa.

Tällä sivulla

ShopifyQL-yleiskatsaus

Kauppasi tiedot tallennetaan tietokantataulukoihin, jotka on jäsennelty määritettyihin sarakkeisiin ja riveihin. Sarakkeet määrittävät, minkä tyyppisiä tietoja ne sisältävät, kuten myynti, ja rivit määrittävät tietotyypin todellisen arvon, kuten 2 450 Yhdysvaltain dollarin myynnin.

Jotta voit noutaa tiedot kuvaavassa muodossa, tietokantaan on lähetettävä kysely. Kysely on kysymys, joka pyytää vastauksena tiettyjä tietoja. Kyselykieli, kuten ShopifyQL, on vakiomuotoinen tapa muodostaa tällainen kysymys. Kysely koostuu avainsanoista ja niitä vastaavista parametreista. Useiden avainsanojen ja tiettyjen parametrien yhdistelmä muodostaa kyselysi. Kun olet luonut kyselysi, voit suorittaa sen ja saada vastauksen.

Tämä on esimerkki ShopifyQL-syntaksista, joka on kirjoitettu kyselymuotoon. Avainsanat on lihavoitu ja niitä vastaavat parametrit ovat sulkeissa. Tässä näkyvät parametrit ovat paikkamerkkejä:

FROM { table_name }
  SHOW { column1, column2, ... }
  GROUP BY { dimension | date_group }
  WHERE { condition }
  SINCE { date_offset }
  UNTIL { date_offset }
  ORDER BY { column } DESC
  LIMIT { count }

Termistö

ShopifyQL-termien määritelmät
Ehto	Määritelmä
Mitta	Määrite, joka segmentoi tiedot niin, että ne voidaan lajitella ja esittää selkeämmin. Yleisiä esimerkkejä dimensioista ovat aika, tuotteet ja paikat. Dimensioita käytetään parametreina ShopifyQL:ssa.
Avainsana	ShopifyQL-syntaksi, joka toimii kyselyäsi ohjaavana komentona.
Mittarit	Tietojen määrällinen mittaaminen. Tyypillisiä esimerkkejä mittareista ovat kokonaismyynti, tilausten määrä ja bruttovoitto.
Parametri	ShopifyQL-syntaksi, joka identifioi kyselyyn sisällytettävät tietokantaelementit tai tiedot.

## Avainsanojen viitetaulukko {#keyword-reference-table}

Voit käyttää näitä avainsanoja kyselyn kirjoittamisessa:

Luettelo ShopifyQL-avainsanoista
Avainsana	Toiminnallinen käyttö
FROM	Määrittää, mistä tietojoukkotaulukosta voit valita tietoja.
SHOW	Valitsee sarakkeet, jotka haluat poimia tietojoukkotaulukosta.
VISUALIZE	Näyttää tiedot visualisoituna viivana tai palkkina.
GROUP BY	Ryhmittää poimitut tiedot dimension tai aikadimensioiden perusteella.
WHERE	Määrittää ehdon tai ehdot, jotka rivien on täytettävä, jotta ne voidaan valita.
SINCE	Näyttää tiedot määritettyyn menneisyydessä olevaan ajankohtaan asti.
UNTIL	Näyttää tiedot määritettyyn menneisyydessä olevaan aikaan asti.
AIKANA	Näyttää tiedot määritettyyn menneisyydessä olevaan ajankohtaan asti.
VERTAA KOHTEESEEN	Näyttää tiedot määritettyyn menneisyydessä olevaan aikaan asti.
ORDER BY	Määrittää, minkä sarakkeen mukaan tiedot järjestetään.
LIMIT	Rajoittaa näytettävien tietorivien määrää.
AS	Nimeää sarakkeen uudelleen valitsemallasi nimellä.

## ShopifyQL-kyselyjen kirjoittaminen {#writing-shopifyql-queries}

ShopifyQL-kyselyt voivat olla perustasoisia, kun halutaan ylätason koontitietoja tai kattavia, kun halutaan yksityiskohtaisia tietoja. Jokaisella avainsanalla on tietty tehtävä, joka kehittää kyselyäsi.

ShopifyQL-perusteet: FROM ja SHOW

Yksinkertaisimman ShopifyQL-kyselyn luominen vaatii vain kaksi tilaukseen kirjoitettua avainsanaa: FROM ja SHOW. FROM, jonka perässä on taulukon nimiparametri, määrittää, missä taulukossa haluat kyselyä käyttää. SHOW, jonka perässä on sarakkeen nimiparametri, määrittää sarakkeet, jotka haluat valita.

Voit esimerkiksi luetella kaikki tuotetunnukset ja niitä vastaavat nimet myyntitaulukosta kirjoittamalla tämän kyselyn:

FROM products
  SHOW product_id, product_title

Tietojen ryhmittely: GROUP BY

Voit segmentoida mittarin dimensionmukaan ryhmitelläksesi esimerkiksi myyntiä alueen mukaan käyttämällä GROUP BY -avainsanaa. GROUP BY -avainsana voidaan yhdistää mihin tahansa dimensioparametriin.

Esimerkiksi kysely, joka ryhmittää toimitushinnat laskutusosoitteen maan ja alueen perusteella, kirjoitetaan seuraavasti:

FROM orders
  SHOW shipping
  GROUP BY billing_country, billing_region

Tässä on toinen kyselyesimerkki, jossa käytetään aikadimensiota nettomyynnin näyttämiseen kuukauden mukaan:

FROM orders
  SHOW net_sales
  GROUP BY month

Yllä oleva kysely ei palauta sellaisia kuukausia, jolloin sinulla ei ollut myyntiä. Jos haluat, että kysely palauttaa aikajakson täydellisenä ja katkeamattomana, käytä ALL-muuttujaa:

FROM orders
  SHOW net_sales
  GROUP BY month ALL
  SINCE last_year
  UNTIL today

Kun käytät ALL-määrettä, sinun on määritettävä myös SINCE ja UNTIL. Huomaa, että ALL-määre toimii vain aikadimension kanssa.

Aikadimensiot

Voit käyttää seuraavia aikadimensioita tietojesi ryhmittelemiseen:

ShopifyQL-aikadimensiot
Operaattori	Toiminnallinen käyttö
tunti	Ryhmittely kalenteripäivän tunnin mukaan.
päivä	Ryhmittely kalenteripäivän mukaan.
viikko	Ryhmittely kalenteriviikon mukaan.
kuukausi	Ryhmittely kalenterikuukauden mukaan.
vuosineljännes	Ryhmittely kalenterineljänneksen mukaan.
vuosi	Ryhmittely kalenterivuoden mukaan.
hour_of_day	Ryhmittely 24 tunnin mukaan (1,2,...,24).
day_of_week	Ryhmittely viikonpäivän mukaan (ma, ti, ke, ..., su).
week_of_year	Ryhmittely viikon mukaan (1,2,...,52).

Tietojen suodatus: WHERE

WHERE-avainsanan avulla voit käyttää dimensiosuodatinta koko ShopifyQL-kyselyssä.

Jos esimerkiksi haluat palauttaa nettomyynnin kuukauden mukaan ryhmiteltynä, mutta vain tietyn alueen osalta, kyselysi on:

FROM orders
  SHOW net_sales
  GROUP BY month ALL
  WHERE billing_region = 'ohio'
  SINCE last_year
  UNTIL today

Yllä olevassa esimerkissä näytetään, miten voit suodattaa tulokset WHERE-parametrilla, vaikka kyseinen parametri ei sisälly SHOW- tai GROUP BY ‑avainsanoihin. Tässä tapauksessa nettomyyntistä suodatetaan kaikilta kuukausilta vain tilaukset, joiden laskutusosoite on Ohiossa, vaikka billing_region ei sisälly tulosjoukkoon.

Vertailuoperaattorit

WHERE-avainsanassa käytetään vertailuoperaattoreita tietojen suodattamiseen. Yllä olevassa esimerkissä '=' määritti, että tietyn arvon kyselysuodattimet ovat kuitenkin käytettävissäsi muissa operaattoreissa:

ShopifyQL-vertailuoperaattorit
Vertailuoperaattori	Toiminnallinen käyttö
=	yhtä suuri kuin
!=	ei ole yhtä suuri kuin
<	pienempi kuin
>	suurempi kuin
<=	pienempi tai yhtä suuri kuin
>=	suurempi tai yhtä suuri kuin

#### Loogiset operaattorit

Jotta voit suodattaa tietojasi tarkemmin, voit lisätä kyselyyn loogisia operaattoreita. ShopifyQL:n loogiset operaattorit on lueteltu alla:

ShopifyQL:n loogiset operaattorit
Looginen operaattori	Toiminnallinen käyttö
AND	Suodatin, jonka avulla voit näyttää kaikki rivit, joissa AND-operaattori erottaa ehdot, jotka täyttyvät.
TAI	Suodatin, jonka avulla voit näyttää kaikki rivit, joissa OR-operaattori erottaa ehdot, joista jompi kumpi täyttyy.
NOT	Suodatin, jonka avulla voit näyttää vain rivit, joiden ehdot eivät täyty, kuten rivit, jotka eivät sisällä tiettyä arvoa.

Voit käyttää WHERE-avainsanan kanssa useita suodattimia lisäämällä loogisia operaattoreita.

Jos haluat saada kuukausittaisen ryhmittelyn niiden tilausten nettomyynnistä, joiden laskutusosoite oli Ohiossa ja joissa sovelletaan alennusta, käytä seuraavaa kyselyä:

FROM orders
  SHOW net_sales
  GROUP BY month ALL
  WHERE billing_region = 'ohio' AND discounts > 0
  SINCE last_year
  UNTIL today

Ajanjaksot: SINCE ja UNTIL

Jos haluat suodattaa kyselyä päivämäärän tai jonkin ajanjakson mukaan, voit käyttää SINCE- ja UNTIL-avainsanoja ja niihin liittyviä parametreja. Nämä avainsanat ovat poikkeuksellisia, koska ne suodattavat vain ajanjaksoja.

Tämä on esimerkiksi kysely, joka löytää nettomyynnin viimeisen 12 kuukauden ajalta Kanadassa tästä päivästä alkaen:

FROM orders
  SHOW net_sales
  GROUP BY month ALL
  WHERE billing_country = 'Canada'
  SINCE -12m
  UNTIL today

Siirtymäoperaattorit

Voit suodattaa tietoja tiettyjen päivämäärien tai päivämäärien siirtymien mukaan. ShopifyQL-siirtymäoperaattoreja ovat seuraavat:

ShopifyQL-siirtymäoperaattorit
Siirtymäoperaattori	Toiminnallinen käyttö
-{#}d	Päivien määrä päivästä, jolloin kysely on suoritetaan.
-{#}w	Viikkojen määrä päivästä, jolloin kysely suoritetaan.
-{#}m	Kuukausien määrä päivästä, jolloin kysely suoritetaan.
-{#}q	Vuosineljännesten määrä päivästä, jolloin kysely on suoritetaan.
-{#}y	Vuosien määrä päivästä, jolloin kysely on suoritetaan.
pp-kk-vvvv	Tietty päivämäärä.
tänään	Päivämäärä, jona kysely suoritetaan.
eilen	Edellinen 24 tunnin jakso kyselyn suorittamisesta.

Suodatus ajanjaksojen mukaan: DURING

AIKANA-avainsana yksinkertaistaa päivämääräsuodatusta päivämäärävälien mukaan. AIKANA-avainsanan avulla voit suodattaa kyselytuloksia tietyn ajanjakson, kuten kalenterivuoden tai tietyn kuukauden, tai ajanjaksojen osalta, joissa on eri päivämäärät eri vuosina, kuten Black Friday Cyber Monday. Esimerkki:

FROM orders
  SHOW sum(net_sales)
  GROUP BY day ALL
  DURING bfcm2021

AIKANA hyväksyy minkä tahansa seuraavista nimetyille aikavälin operaattoreille:

ShopifyQL-nimetyt aikavälin operaattorit
Aikavälin operaattori	Toiminnallinen käyttö
tänään	Päivämäärä, jona kysely on suoritettava.
eilen	Edellinen 24 tunnin jakso kyselyn suorittamisesta.
this_week	Nykyinen kalenteriviikko.
this_month	Nykyinen kalenterikuukausi.
this_quarter	Nykyinen kalenterineljännes.
this_year	Nykyinen kalenteriviikko.
last_week	Edellinen kalenteriviikko.
last_month	Edellinen kalenterikuukausi.
last_quarter	Edellinen kalenterineljännes.
last_year	Edellinen kalenteriviikko.
bfcm2022	25. marraskuuta–28. marraskuuta 2022.
bfcm2021	26. marraskuuta–29. marraskuuta 2021.

Vertailu eri ajanjaksoilla: COMPARE TO

VERTAA-avainsanan avulla voit vertailla AIKANA-aikavälin ja VERTAA-aikavälin tietoja. Se hyväksyy minkä tahansa AIKANA-osiossa luetellun nimetyn aikavälin operaattorin. VERTAA-kohdassa käytetyn operaattorin ajan pituus on oltava sama kuin AIKANA-kohdassa käytetty aika.. Esimerkiksi DURING this_week COMPARE TO last_week on kelvollinen yhdistelmä, mutta DURING this_week COMPARE TO last_month ei ole.

Seuraavassa esimerkissä vertaillaan vuoden 2022 Black Friday Cyber Monday nettomyyntiä Black Friday Cyber Monday 2021:n nettomyyntiin.

FROM orders
  SHOW sum(net_sales)
  GROUP BY day ALL
  DURING bfcm2022
  COMPARE TO bfcm2021

Tietojen lajittelu: ORDER BY

Voit määrittää, miten haluat lajitella kyselysi palauttamat tiedot käyttämällä ORDER BY -avainsanaa ja sen parametreja. ASC-parametri järjestää tiedot nousevaan järjestykseen ja DESC laskevaan järjestykseen.

Voit määrittää minkä tahansa kyselyyn lisättävän mittarin tai dimension ORDER BY -avainsanassa, useita kenttiä mukaan lukien.

Tämä kysely esimerkiksi palauttaa kunkin laskutusosoitteen maan ja alueen nettomyynnin käänteisessä aakkosjärjestyksessä laskutusosoitteen maan mukaan ja sitten laskutusosoitteen alueen mukaan kussakin maassa.

FROM orders
  SHOW net_sales
  GROUP BY billing_country, billing_region
  SINCE -1y
  UNTIL today
  ORDER BY billing_country, billing_region DESC

Järjestyksellä, jossa kirjoitat mittareita tai dimensioita, on merkitystä. Jos määrität ORDER BY -parametrille useita arvoja, lajittelua sovelletaan mittareihin tai mittoihin tässä järjestyksessä.

Rajoittaminen

LIMIT-avainsanan avulla voit määrittää, kuinka monta riviä kysely palauttaa. Tämä on kätevää, kun haluat vain ymmärtää sarakkeen tietojen ulkoasua. Voit myös yhdistää sen ORDER BY -avainsanan avulla, jos haluat luoda ylä- ja alaluetteloja.

Tässä esimerkissä käytetään LIMIT- ja ORDER BY -avainsanoja, jotka kokoavat listan kymmenestä määrän mukaan eniten myydystä tuotteesta viimeisen kolmen kuukauden aikana:

FROM products
  SHOW net_product_quantity
  GROUP BY product_title
  SINCE -3m
  UNTIL today
  ORDER BY net_product_quantity DESC
  LIMIT 10

Kyselydiagrammit: VISUALIZE ja TYPE

VISUALIZE-avainsanan avulla voit kirjoittaa ShopifyQL-kyselyn, joka visualisoi tiedot viiva- tai pylväsdiagrammiin.

TYPE-avainsana on valinnainen, ja sen yhteydessä on oltava valittuna "viiva" tai "pylväs", jotta kysely palauttaa visualisoinnin joko viivadiagrammina tai pylväsdiagrammina. Jos TYPE ei sisälly kyselyyn, ShopifyQL päättää automaattisesti parhaiten kyselyysi sopivan visualisoinnin. Jos kyselyäsi ei voida visualisoida kirjoitettuna, ShopifyQL palauttaa tiedot taulukkomuodossa.

Voit esimerkiksi visualisoida kuukausittaiset myyntitrendisi viimeisen vuoden ajalta trendiviivan avulla. Tämä kysely palauttaa aikasarjakuvaajan, joka esittää kuukausittaisen bruttomyynnin viimeisen vuoden ajalta. Myyntiä kuvaa viiva, jonka x-akselilla on kuukaudet ja y-akselilla bruttomyynti:

FROM orders
  VISUALIZE gross_sales
  TYPE line
  GROUP BY month ALL
  SINCE -1y
  UNTIL today

Matemaattiset operaattorit

ShopifyQL mahdollistaa laskutoimenpiteiden suorittamisen tietojesi mittareilla. Käytettävissä on seuraavat matemaattiset operaattorit:

ShopifyQL-siirtymäoperaattorit
Matemaattinen operaattori	Toiminnallinen käyttö
+	Lisätään kaksi numeroa.
-	Vähennetään kaksi numeroa.
*	Kerrotaan kaksi numeroa.
/	Jaetaan kaksi numeroa.

Tämä kysely laskee esimerkiksi kunkin alueen tilauksen arvon viimeisen vuoden ajalta. Kun käytät matemaattisia operaattoreita ja mittareja, voit liittää uuteen mittariin uuden nimen AS-avainsanan avulla.

FROM orders
  SHOW (net_sales + returns) AS order_value, orders, (net_sales + returns)/orders AS sales_per_order
  GROUP BY billing_region
  SINCE -1y
  UNTIL today

Toiminnot

ShopifyQL-funktioiden avulla voit koostaa sarakkeita, jotka ovat samankaltaisia kuin Microsoft Excelin pivot-taulukot. Sarakkeiden koostaminen tarkoittaa uuden arvon luomista sarakkeita yhdistämällä Seuraavat funktio-operaattorit ovat käytettävissä ShopifyQL:n nykyisessä versiossa:

ShopifyQL-siirtymäoperaattorit
Funktio-operaattori	Toiminnallinen käyttö
count()	Esiintymien määrä tulosjoukossa.
sum()	Arvojen summaus tulosjoukossa.
min()	Tulosjoukon vähimmäisarvo.
max()	Tulosjoukon enimmäisarvo.
avg()	Tulosjoukon keskimääräinen arvo.

sum-, min-, max- ja avg-funktioita voidaan käyttää vain numeerisilla arvoilla, kun taas count-funktiolla voidaan laskea eri mitta-attribuuttien ilmentymät. Et voi käyttää koostettuja kenttiä funktioiden argumenteina. Koostetut kentät päätät muuttujiin _sum, _counttai _percent.

Esimerkiksi tämä kysely palauttaa virheen, koska total_sales on jo koostettu:

FROM orders
  SHOW sum(total_sales)

Tämä on kelvollinen kysely, joka yhdistää koostetoimintoja koostamiskenttiin:

FROM orders
  SHOW average_order_value, sum(gross_sales)
  GROUP BY billing_region
  SINCE 2021-01-01
  UNTIL 2021-12-31

Tämä kysely palauttaa sum-funktion tuloksena yhteenlasketun keskimääräisen tilauksen arvon eli bruttomyynnin summan. Nämä mittarit on eritelty laskutusosoitteen alueen mukaan kaikkien vuonna 2021 tehtyjen tilausten mukaan.

Kommentit

Kommenttien avulla voit selittää ShopifyQL-lausekkeiden osia tai estää ShopifyQL-lausekkeen suorittamisen. Kaikki kommentin tekstit ohitetaan suoritusajan aikana.

Yhden rivin kommentit alkavat -- ja loppuvat rivin loppuun.

Usean rivin kommentit alkavat /* ja loppuvat */.

FROM orders
  SHOW average_order_value, sum(gross_sales)
  -- the line below has been commented out and will not run
  -- GROUP BY billing_region
  WHERE billing_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
*/