ShopifyQL:n käyttäminen Notebooksissa

ShopifyQL on Shopifyn kaupankäyntiä varten kehitetty kyselykieli. Kyselykieltä käytetään tietojen pyytämiseen ja noutamiseen 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.

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 kyselyn. 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

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.
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

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 mittarindimensionmukaan 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 laskutusmaan 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.

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 laskutusmaan ja -alueen myynnin summan, joka lajitellaan ensin käänteisessä aakkosjärjestyksessä laskutusmaan mukaan ja sitten kunkin maan laskutusalueen mukaan.

**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 mittareitasi tai mittojasi, on merkitystä. Jos määrität ORDER BY -parametrille useita arvoja, lajittelua sovelletaan mittareihin tai mittoihin tässä järjestyksessä.


Rajoitus

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 laskutusalueen mukaan kaikkien vuonna 2021 tehtyjen tilausten mukaan.

Valmiina aloittamaan Shopifyssa?

Kokeile ilmaiseksi