ShopifyQL தொடரியலின் மேலோட்டப் பார்வை

உங்கள் ஸ்டோரின் அறிக்கைகளில் உள்ள தரவை மீட்டெடுக்கவும் வடிவமைக்கவும் ShopifyQL வினவல் தொடரியலைப் பயன்படுத்தலாம். வினவல் என்பது உங்களின் தரவிடம் நீங்கள் கேட்கும் கேள்வியாகும். FROM தரவுத்தொகுப்பைத் தேர்ந்தெடுக்கிறது, SHOW திருப்பியளிக்க வேண்டிய தரவைத் தேர்ந்தெடுக்கிறது, பிற முக்கியச் சொற்கள் வடிப்பான்கள், குழுவாக்கல்கள், தேதிக்காலங்கள், ஒப்பீடுகள் மற்றும் காட்சிப்படுத்தல்களைச் சேர்க்கின்றன.

பின்வரும் எந்தவொரு நோக்கங்களுக்காகவும் ShopifyQL தொடரியலைப் பயன்படுத்தலாம்:

கலைச்சொற்கள்

பரிமாணம், முக்கியச் சொல், ஆப்பரேட்டர் போன்ற ShopifyQL சொற்களின் வரையறைகள்.
சொல்வரையறை
பரிமாணம்தரவை எளிதாக வரிசைப்படுத்தித் தெளிவாக வழங்குவதற்கு, அதைப் பிரிக்கும் ஒரு பண்புக்கூறு. நேரம், தயாரிப்புகள், இடங்கள் ஆகியவை பரிமாணங்களுக்கான பொதுவான எடுத்துக்காட்டுகளில் அடங்கும். ShopifyQL-இல் பரிமாணங்கள் அளபுருக்களாகப் பயன்படுத்தப்படுகின்றன.
முக்கியச் சொல்உங்கள் வினவலை இயக்குவதற்கான கட்டளையாகச் செயல்படும் ShopifyQL தொடரியல்.
அளவீடுதரவின் அளவுசார் அளவீடு. மொத்த விற்பனை, ஆர்டர்களின் எண்ணிக்கை, மொத்த லாபம் ஆகியவை அளவீடுகளுக்கான பொதுவான எடுத்துக்காட்டுகளில் அடங்கும்.
அளபுருஉங்கள் வினவலில் சேர்க்கப்பட வேண்டிய தரவுத்தளக் கூறுகள் அல்லது விவரங்களை அடையாளம் காணும் ShopifyQL தொடரியல்.
ஆப்பரேட்டர்வினவலின் ஒரு பகுதியாகப் பயன்படுத்தப்படும் ஒதுக்கப்பட்ட சொல் அல்லது எழுத்து. பின்வருபவை எடுத்துக்காட்டுகளில் அடங்கும் STARTS WITH, >= அல்லது last_week.

ShopifyQL தொடரியல் விதிகள்

ShopifyQL-ஐப் பயன்படுத்தி சரியான அறிக்கை வினவலை உருவாக்கும்போது, பின்வரும் தேவைகளைப் பூர்த்தி செய்ய வேண்டும்:

  • நீங்கள் ஒரு வினவல் முழுவதையும் ஒரே வரியிலோ அல்லது தனித்தனி வரிகளிலோ வைக்கலாம்.
  • நீங்கள் குறைந்தபட்சம் FROM மற்றும் SHOW முக்கியச் சொற்களை அவற்றுக்குரிய அளபுருக்களுடன் கட்டாயம் சேர்க்க வேண்டும். பிற முக்கியச் சொற்கள் மற்றும் அளபுருக்கள் அனைத்தும் விருப்பத்திற்குரியவை.
  • ஒரு வினவலில் உள்ள அனைத்து முக்கியச் சொற்களும் பின்வரும் வரிசையிலேயே சேர்க்கப்பட வேண்டும்:
  1. FROM
  2. SHOW
  3. WHERE
  4. GROUP BY
  5. TIMESERIES
  6. WITH TOTALS, GROUP_TOTALS, PERCENT_CHANGE, CUMULATIVE_VALUES, CURRENCY, TIMEZONE
  7. HAVING
  8. SINCE மற்றும் UNTIL, அல்லது DURING
  9. COMPARE TO மற்றும் விருப்பத்திற்குரிய UNTIL
  10. ORDER BY
  11. LIMIT
  12. VISUALIZE மற்றும் TYPE, MAX, ANNOTATE

இது சரியான தொடரியலைப் பயன்படுத்தி வினவலாக எழுதப்பட்ட ShopifyQL-க்கான ஒரு எடுத்துக்காட்டு. அளபுருக்கள் பொதுவான இடநிரப்பிகளைப் பயன்படுத்திச் சேர்க்கப்பட்டுள்ளன, விருப்பத்திற்குரிய அளபுருக்கள் அடைப்புக்குறிக்குள் உள்ளன:

FROM table_name1, table_name2, ...
SHOW column1 { AS alias }, column2 { AS alias }, ...
WHERE condition
GROUP BY dimension
TIMESERIES time_dimension WITH TOTALS, GROUP_TOTALS, PERCENT_CHANGE, CUMULATIVE_VALUES, CURRENCY 'currency_code', TIMEZONE 'iana_timezone'
HAVING condition
SINCE date_offset
UNTIL date_offset
DURING named_date_range
COMPARE TO [ date_offset { UNTIL date_offset }, ... | TARGETS ]
ORDER BY column { ASC | DESC }
LIMIT number { OFFSET number }
VISUALIZE [ alias1, alias2, ... ]
  TYPE { visualization_type }
  MAX number
  ANNOTATE annotation_category { FILTER annotation_filter }

இந்த WITH முக்கியச் சொல் தான் தொடரும் முக்கியச் சொல்லை மாற்றியமைக்கிறது, எனவே அது பொருந்தக்கூடிய GROUP BY அல்லது TIMESERIES அறிக்கையின் முடிவில் எழுதப்படுகிறது, எடுத்துக்காட்டாக TIMESERIES day WITH TOTALS.

ShopifyQL முக்கியச் சொற்கள்

ShopifyQL வினவல்கள், மேல்நிலைத் தரவு நுண்ணறிவுகளுக்கான அடிப்படையான வினவல்களில் இருந்து விரிவான நுண்ணறிவுகளுக்கான விரிவான வினவல்கள் வரை இருக்கலாம். ஒவ்வொரு முக்கியச் சொல்லுக்கும் உங்கள் வினவலை உருவாக்கும் குறிப்பிட்ட செயல்பாடு உள்ளது.

ShopifyQL முக்கியச் சொற்கள் மற்றும் அவற்றின் விளக்கங்களின் பட்டியல்.
முக்கியச் சொல்விளக்கம்
FROMஎந்தத் தரவுத்தொகுப்பு அட்டவணையிலிருந்து தரவைத் தேர்ந்தெடுக்க வேண்டும் என்பதைக் குறிப்பிடுகிறது.
SHOWதரவுத்தொகுப்பு அட்டவணையிலிருந்து நீங்கள் பிரித்தெடுக்க விரும்பும் நெடுவரிசைகளைத் தேர்ந்தெடுக்கிறது.
WHEREவரிசைகளைத் தேர்ந்தெடுப்பதற்கு, அவை பூர்த்தி செய்ய வேண்டிய நிபந்தனை அல்லது நிபந்தனைகளை வரையறுக்கிறது.
GROUP BYபிரித்தெடுக்கப்பட்ட தரவை ஒரு பரிமாணம் அல்லது நேரப் பரிமாணங்களின் அடிப்படையில் குழுவாக்குகிறது.
TIMESERIESநேரப் பரிமாணங்களின் அடிப்படையிலான குழுவாக்கத்தை வேறுபடுத்துகிறது, மேலும் ஒரு வினவலில் உள்ள தேதிகளைப் பின்னிரப்புகிறது.
WITHகுறிப்பிட்ட ShopifyQL முக்கியச் சொற்களின் செயல்பாட்டை மாற்றியமைக்கிறது.
HAVINGவினவலின் முடிவுகள் குழுவாக்கப்பட்ட பிறகு, அவற்றை வடிகட்டுகிறது.
SINCEகடந்த காலத்தில் குறிப்பிடப்பட்ட ஒரு நேரத்திலிருந்தான தரவைச் சேர்க்கும். பொதுவாக இதனுடன் இணைக்கப்படும்: UNTIL.
UNTILகடந்த காலத்தில் குறிப்பிடப்பட்ட ஒரு நேரம் வரையிலான தரவைச் சேர்க்கும். பொதுவாக இதனுடன் இணைக்கப்படும்: SINCE அல்லது COMPARE TO.
DURINGகடந்த காலத்தில் குறிப்பிடப்பட்ட ஒரு நேரத்தின் இடையிலான தரவைச் சேர்க்கும்.
COMPARE TOகடந்த காலத்தில் குறிப்பிடப்பட்ட ஒரு நேரத்துடனான ஒப்பீட்டுக்கான தரவைச் சேர்க்கும்.
ORDER BYஎந்த நெடுவரிசையின் அடிப்படையில் தரவை வரிசைப்படுத்த வேண்டும் என்பதைக் குறிப்பிடுகிறது.
LIMITகாட்டப்படும் தரவு வரிசைகளின் எண்ணிக்கையைக் கட்டுப்படுத்துகிறது.
VISUALIZEஉங்கள் தரவை ஒரு காட்சிப்படுத்தலில் காட்டுகிறது. எந்தக் காட்சிப்படுத்தல் வேண்டும் என்பதை நீங்கள் இதன்மூலம் குறிப்பிடலாம்: TYPE, எடுத்துக்காட்டாக line, bar, donut, அல்லது histogram.
ANNOTATEநேர அச்சு உள்ள காட்சிப்படுத்தலில் சிறுகுறிப்புகளைக் காட்டுகிறது.
ASஒரு நெடுவரிசையை நீங்கள் விரும்பும் பெயருக்கு மாற்றும் ஒரு விருப்பத்தேர்வான முக்கியச் சொல்.

FROM மற்றும் SHOW

மிகவும் எளிமையான ShopifyQL வினவலை உருவாக்க வெறும் 2 முக்கியச் சொற்கள் தேவை: FROM மற்றும் SHOW, அதே வரிசையில் எழுதப்பட்டிருக்க வேண்டும். FROMஎன்பதைத் தொடர்ந்து, ஒன்று அல்லது அதற்கு மேற்பட்ட அட்டவணைப் பெயர் அளவுருக்களைப் பயன்படுத்தினால், நீங்கள் எந்த அட்டவணைகளை வினவ வேண்டும் என்பதைக் குறிப்பிடுகிறது. SHOWஎன்பதைத் தொடர்ந்து, எத்தனை நெடுவரிசைப் பெயர் அளவுருக்களைப் பயன்படுத்தினாலும், நீங்கள் தேர்ந்தெடுக்க விரும்பும் நெடுவரிசைகளைக் குறிப்பிடுகிறது.

SHOW என்பதை, அறிக்கையில் அளவீடுகள் மற்றும் பரிமாணங்கள் வழங்கப்படும் வரிசையைக் குறிப்பிடப் பயன்படுத்தலாம்.

எடுத்துக்காட்டாக, இந்த வினவலை எழுதுவதன் மூலம், நீங்கள் மொத்த விற்பனையின் கூடுதலைப் பெறலாம்:

FROM sales
  SHOW total_sales

கிடைக்கக்கூடிய தரவுத்தொகுப்புகளின் பட்டியலுக்கு Shopify டெவலப்பர் ஆவணங்களைப் பார்க்கவும்.

WHERE

இந்த WHERE எனும் முக்கியச் சொல் மூலம் ஒட்டுமொத்த ShopifyQL வினவலிலும் பரிமாண வடிகட்டியைப் பயன்படுத்தலாம். இந்த வடிகட்டியை ஒப்பீட்டு ஆப்பரேட்டர்கள் (அதாவது > போன்ற பெரியது குறி), லாஜிக்கல் ஆப்பரேட்டர்கள் (அதாவது AND அல்லது NOT), மற்றும் பகுதிச் சரம் மற்றும் வரிசைப் பொருத்தம் (அதாவது STARTS WITH மற்றும் CONTAINS) ஆகியவற்றின் மூலம் மாற்றியமைக்கலாம்.

நீங்கள் இதைப் பயன்படுத்தலாம்: WHERE , ஒரு குறிப்பிட்ட பகுதியின் மீது நீங்கள் கவனம் செலுத்த விரும்பும் போது (எடுத்துக்காட்டாக ஒரே நாட்டிலிருந்து பெறப்பட்ட ஆர்டர்கள், குறிப்பிட்ட தயாரிப்பின் விற்பனைகள் அல்லது குறிப்பிட்ட மதிப்பிற்கு மேலான பரிவர்த்தனைகள்).

WHERE நிபந்தனைகள் பின்வரும் தேவைகளைப் பூர்த்தி செய்ய வேண்டும்:

  • மதிப்புகள் இரட்டை மேற்கோள்களில் (") அல்லாமல், ஒற்றை மேற்கோள்களில் (') மட்டுமே இருக்க வேண்டும்.
  • நிபந்தனைகளில் எந்தவொரு எண்கணிதக் குறியீடும் இருக்கக்கூடாது.
  • நிபந்தனைகள் ஒரு அளவீட்டை அல்லாமல், ஒரு பரிமாணத்தை மட்டுமே குறிப்பிட முடியும்.

எடுத்துக்காட்டாக, பில்லிங் நாட்டின் அடிப்படையில் வடிகட்டப்பட்ட மொத்த விற்பனையைப் பெற, உங்களின் வினவல் இதுவாக இருக்க வேண்டும்:

FROM sales
  SHOW total_sales, product_title, product_type, product_vendor
  WHERE billing_country='Canada'
  GROUP BY product_title, product_type, product_vendor

முந்தைய எடுத்துக்காட்டில் உள்ளபடி, முடிவுகளின் தொகுப்பை நீங்கள் இதைக் கொண்டு வடிகட்டலாம்: WHERE அளவுரு, அந்த அளவுரு இதில் சேர்க்கப்படாதபோதும்: SHOW முக்கியச் சொல். இந்தச் சூழலில், கனடாவிலிருந்து பெறப்பட்ட ஆர்டர்களுக்கு மட்டுமே மொத்த விற்பனை வடிகட்டப்படுகிறது, இதில் இது இல்லாமல் இருந்தாலும்கூட: billing_country முடிவுகளின் தொகுப்பில் சேர்க்கப்படவில்லை.

ஒப்பீட்டு ஆப்பரேட்டர்கள்

இந்த WHERE முக்கியச் சொல், தரவை வடிகட்ட ஒப்பீட்டு ஆப்பரேட்டர்களைப் பயன்படுத்துகிறது. முந்தைய எடுத்துக்காட்டில், ஒரு குறிப்பிட்ட மதிப்பில் வினவல் வடிகட்டப்படுவதைக் குறிப்பிட = பயன்படுத்தப்பட்டது, இருப்பினும், உங்களுக்கு பிற ஆப்பரேட்டர்களும் உள்ளன:

பெரியது அல்லது சமமானது போன்ற ShopifyQL ஒப்பீட்டு ஆப்பரேட்டர்களின் பட்டியல்.
ஒப்பீட்டு ஆப்பரேட்டர்விளக்கம்
=சமமானது
!=சமமற்றது
<சிறியது
>பெரியது
<=சிறியது அல்லது சமமானது
>=பெரியது அல்லது சமமானது

லாஜிக்கல் ஆப்பரேட்டர்கள்

உங்கள் தரவை மேலும் வடிகட்ட, உங்கள் வினவலில் லாஜிக்கல் ஆப்பரேட்டர்களைச் சேர்க்கலாம். ShopifyQL லாஜிக்கல் ஆப்பரேட்டர்கள் ஆவன:

AND, OR மற்றும் NOT போன்ற ShopifyQL லாஜிக்கல் ஆப்பரேட்டர்களின் பட்டியல்.
லாஜிக்கல் ஆப்பரேட்டர்விளக்கம்
ANDஇதனால் பிரிக்கப்பட்ட நிபந்தனைகள் பூர்த்தி செய்யப்பட்டுள்ள அனைத்து வரிசைகளையும் சேர்க்க, வடிகட்டவும்: AND பூர்த்தியாகின்றன.
ORஇதனால் பிரிக்கப்பட்ட நிபந்தனைகளில் ஏதேனும் ஒன்று பூர்த்தி செய்யப்பட்டுள்ள அனைத்து வரிசைகளையும் சேர்க்க, வடிகட்டவும்: OR பூர்த்தியாகின்றன.
NOTகுறிப்பிடப்பட்ட மதிப்பைக் கொண்டிராத வரிசைகள் போன்ற, நிபந்தனைகள் பூர்த்தி செய்யப்படாத வரிசைகளை மட்டும் சேர்க்க வடிகட்டவும்.

நீங்கள் இதில் பல வடிகட்டிகளைப் பயன்படுத்தலாம்: WHERE முக்கியச் சொல் (லாஜிக்கல் ஆப்பரேட்டர்களைச் சேர்ப்பதன் மூலம்).

கனடாவில் பில்லிங் முகவரியைக் கொண்ட, தள்ளுபடி பயன்படுத்தப்பட்ட உலர் பீச்சுகள் அடங்கிய அனைத்து ஆர்டர்களுக்கான நிகர விற்பனையின் மாதாந்திரக் குழுவாக்கத்தைப் பெற, அந்த எடுத்துக்காட்டுத் தரவுத்தொகுப்பு வினவலுடன் இதையும் சேர்க்கவும்:

FROM sales
  SHOW total_sales, product_title, product_type, product_vendor
  WHERE billing_country = 'Canada' AND product_title = 'Dried Peaches' AND is_discounted_sale = true
  GROUP BY product_title, product_type, product_vendor

AND என்பது இதற்கு முன்னதாக மதிப்பிடப்படும்: OR. மதிப்பீடு செய்யப்படும் வரிசையைக் கட்டுப்படுத்த, அடைப்புக்குறிகளைப் பயன்படுத்தி உங்கள் நிபந்தனைகளைக் குழுவாக்கவும், எடுத்துக்காட்டாக: WHERE billing_country = 'Canada' AND (product_type = 'Fruit' OR product_type = 'Nuts').

வரம்பு மற்றும் மெம்பர்ஷிப் ஆப்பரேட்டர்கள்

நீங்கள் ஒரு மதிப்புகளின் பட்டியலுடன் ஒரு பரிமாணத்தை ஒப்பிடலாம் அல்லது ஒரு மதிப்பு வரம்பிற்குள் வருகிறதா எனப் பரிசோதிக்கலாம்:

IN, NOT IN, BETWEEN மற்றும் NOT BETWEEN உள்ளிட்ட ShopifyQL வரம்பு மற்றும் மெம்பர்ஷிப் ஆபரேட்டர்களின் பட்டியல்.
ஆப்பரேட்டர்விளக்கம்
INபட்டியலில் உள்ள ஏதேனும் ஒரு மதிப்புடன் ஒப்பிடலாம், எடுத்துக்காட்டாக WHERE billing_country IN ('Canada', 'United States').
NOT INபட்டியலில் உள்ள ஒவ்வொரு மதிப்பையும் தவிர்க்கலாம்.
BETWEENவரம்பிற்குள் உள்ள மதிப்புகளுடன் ஒப்பிடலாம், எடுத்துக்காட்டாக WHERE number_of_products_bought_together BETWEEN 2 AND 4. இதில் குறைந்த மதிப்பு மற்றும் அதிக மதிப்பு ஆகிய இரண்டும் அடங்கும்.
NOT BETWEENவரம்பிற்குள் உள்ள மதிப்புகளைத் தவிர்க்கலாம். குறைந்த மதிப்பு மற்றும் அதிக மதிப்பு ஆகிய இரண்டும் இதில் தவிர்க்கப்படும்.

Null மற்றும் பூலியன் சோதனைகள்

ஒரு மதிப்புடன் பரிமாணத்தை ஒப்பிடாமலேயே, விடுபட்ட மதிப்புகள் அல்லது பூலியன் நிலைகளுக்காக நீங்கள் வடிகட்டலாம். NOT என்பதற்குப் பிறகு IS என்பதைச் சேர்த்து இந்தச் சோதனைகளில் ஏதேனும் ஒன்றைத் தலைகீழாக்கலாம்:

IS NULL, IS TRUE மற்றும் IS FALSE உள்ளிட்ட ShopifyQL இன் null மற்றும் பூலியன் சோதனை ஆபரேட்டர்களின் பட்டியல்.
ஆப்பரேட்டர்விளக்கம்
IS NULLமதிப்பு விடுபட்டுள்ளது. விடுபட்ட மதிப்புகளை ஏற்கும் எந்தப் பரிமாணத்துடனும் இது செயல்படும்.
IS TRUEமதிப்பு true என உள்ளது. பூலியன் பரிமாணங்களுடன் செயல்படும்.
IS FALSEமதிப்பு false என உள்ளது. பூலியன் பரிமாணங்களுடன் செயல்படும்.

ஒரு தலைகீழாக்கப்பட்ட பூலியன் சோதனையானது, மதிப்பு விடுபட்டுள்ள வரிசைகளுடனும் பொருந்தும். எடுத்துக்காட்டாக, தலைகீழாக்கப்பட்ட true சோதனையானது மதிப்பு false ஆக உள்ள வரிசைகளுக்கும் மதிப்பு விடுபட்டுள்ள வரிசைகளுக்கும் பொருந்தும். தலைகீழாக்கப்பட்ட null சோதனையானது இதற்கு விதிவிலக்காகும், ஏனெனில் இது மதிப்பு இருக்கும் வரிசைகளை மட்டுமே தேர்ந்தெடுக்கும்:

FROM sales
  SHOW total_sales
  WHERE product_type IS NOT NULL AND is_discounted_sale IS NOT TRUE
  GROUP BY product_type

மதிப்புகளை !=, NOT IN, அல்லது NOT CONTAINS மூலம் தவிர்ப்பது, பரிமாணம் விடுபட்டுள்ள வரிசைகளை அகற்றாது. அந்த வரிசைகளையும் நீக்க, அதே பரிமாணத்திற்கு not-null சோதனையைச் சேர்க்கவும்:

FROM sales
  SHOW total_sales
  WHERE product_type != 'Fruit' AND product_type IS NOT NULL
  GROUP BY product_type

வாடிக்கையாளர் நிகழ்வுச் செயல்பாடுகள்

உங்கள் தரவை மேலும் வடிகட்ட, நிபந்தனையுடன் கூடிய வாடிக்கையாளர் நிகழ்வுச் செயல்பாடுகளை உங்கள் வினவலில் சேர்க்கலாம். செயல்பாடுகளின் பெயர்களைத் தொடர்ந்து, MATCHES அல்லது NOT MATCHES மற்றும் விருப்ப அளவுருக்களின் பட்டியலைக் கொண்ட அடைப்புக்குறிகள் ஆகியவை இடம்பெறும்.

உங்கள் வினவல்களில் பின்வரும் ShopifyQL வாடிக்கையாளர் நிகழ்வுச் செயல்பாடுகளைச் சேர்க்கலாம்:

MATCHES மற்றும் NOT MATCHES போன்ற ShopifyQL வாடிக்கையாளர் நிகழ்வுச் செயல்பாடுகளின் பட்டியல்.
வாடிக்கையாளர் நிகழ்வு ஆபரேட்டர்விளக்கம்
{customer_event} MATCHES ({condition1}, {condition2}, ...)அடைப்புக்குறிக்குள் வரையறுக்கப்பட்டுள்ள வாடிக்கையாளர் நிகழ்வு நிபந்தனைகள் பூர்த்தியாகும் அனைத்து வரிசைகளையும் சேர்க்கும் வகையில் வடிகட்டலாம்.
{customer_event} NOT MATCHES ({condition1}, {condition2}, ...)வாடிக்கையாளர் நிகழ்வு நிபந்தனைகள் பூர்த்தியாகாத வரிசைகளை மட்டும் சேர்க்கும் வகையில் வடிகட்டலாம்.

எடுத்துக்காட்டாக, பின்வரும் வினவல் 5 அல்லது அதற்கு மேற்பட்ட ஆர்டர்களைச் செய்த வாடிக்கையாளர்களை மட்டுமே காட்டும்:

FROM customers
  SHOW customer_name, total_number_of_orders
  WHERE orders_placed MATCHES (count >= 5)
  GROUP BY customer_name

அடைப்புக்குறிக்குள் உள்ள நிபந்தனைகள், தொடர்புடைய வாடிக்கையாளர் நிகழ்வுக்குச் சொந்தமான கிடைக்கக்கூடிய அளவுருக்களைப் பிரதிபலிக்க வேண்டும். பின்வரும் இயல்புநிலை வாடிக்கையாளர் நிகழ்வுப் புலங்கள் மற்றும் தொடர்புடைய அளவுருக்களை நீங்கள் WHERE ஸ்டேட்மெண்ட்டில் பயன்படுத்தலாம்:

ShopifyQL இல் உள்ள வாடிக்கையாளர் நிகழ்வுச் செயல்பாடுகள் மற்றும் அவற்றின் அளவுருக்களின் பட்டியல்.
Eventsஅளவுருக்கள்
products_purchased
  • id
  • tag
  • category
  • date
  • quantity
  • sum_quantity
orders_placed
  • date
  • amount
  • location_id
  • app_id
  • count
  • sum_amount
shopify_email.opened
  • activity_id
  • date
  • count
shopify_email.clicked
  • activity_id
  • date
  • count
shopify_email.bounced
  • activity_id
  • date
  • count
shopify_email.marked_as_spam
  • activity_id
  • date
  • count
shopify_email.unsubscribed
  • activity_id
  • date
  • count
storefront_event.product_viewed
  • id
  • date
  • count
storefront_event.collection_viewed
  • id
  • date
  • count
store_credit_accounts
  • currency
  • balance
  • next_expiry_date
  • last_credit_date
within_distance
  • coordinates
  • distance_km அல்லது distance_mi

வாடிக்கையாளர் நிகழ்வுச் செயல்பாடுகளில் உள்ள date அளவுருக்களுக்கு, date = today, date = -30d மற்றும் date = -6m போன்ற தொடர்புடைய தேதிகளை நீங்கள் பயன்படுத்தலாம்.

உங்கள் FROM தரவுத்தொகுப்பானது customers என்பதைத் தவிர வேறொன்றாக இருக்கும்போது, உங்கள் வினவலில் உள்ள வாடிக்கையாளர் தரவுத்தொகுப்பை அணுகுவதற்கு, பொருத்தக்கூடிய புலத்திற்கு முன் customer. என்பதைச் சேர்க்க வேண்டும். எடுத்துக்காட்டாக, customer.products_purchased.

எடுத்துக்காட்டாக, கடந்த 30 நாட்களில் ஒரே ஆர்டரில் 3 அல்லது அதற்கும் மேற்பட்ட சருமப் பாதுகாப்புத் தயாரிப்புகளை வாங்கிய வாடிக்கையாளர்களின் மொத்த விற்பனையை மட்டுமே இந்த வினவல் காட்டும்:

FROM sales
  SHOW total_sales
  WHERE customer.products_purchased MATCHES (tag CONTAINS 'skincare', quantity >= 3)
  GROUP BY month
  SINCE -30d

கூடுதலாக anniversary என்ற வாடிக்கையாளர் நிகழ்வுச் செயல்பாடு கிடைக்கிறது, இதற்கு MATCHES ஆபரேட்டர் தேவையில்லை. தேதி அல்லது நேர வெளியீடுகளைக் கொண்ட customer_added_date அல்லது first_order_date போன்ற வாடிக்கையாளர் பரிமாணங்களுக்கும், metafields.facts.birth_date அல்லது metafields.custom.preferred_delivery_date போன்ற நேரம் அல்லது தேதி தொடர்பான மெட்டாஃபீல்டுகளுக்கும் anniversary செயல்பாடு கிடைக்கும்.

எடுத்துக்காட்டாக, வாடிக்கையாளர் சேர்க்கப்பட்ட தேதியின் ஆண்டுவிழா இன்று உள்ள முடிவுகளை மட்டுமே இந்த ஸ்டேட்மெண்ட் காட்டும்: WHERE anniversary(customer_added_date) = today. மற்றொரு எடுத்துக்காட்டாக, இந்த வாரத்தில் ஏதேனும் ஒரு நேரத்தில் வாடிக்கையாளரின் பிறந்தநாள் (மெட்டாஃபீல்டாகச் சேமிக்கப்பட்டுள்ளது) வரக்கூடிய முடிவுகளை மட்டுமே இந்த ஸ்டேட்மெண்ட் காட்டும்: WHERE anniversary(metafields.facts.birth_date) BETWEEN today AND +7d.

GROUP BY

ஒரு பரிமாணத்தைக் கொண்டு அளவீட்டைப் பிரிக்க (எடுத்துக்காட்டாக, பிராந்தியத்தின் அடிப்படையில் விற்பனையைக் குழுவாக்க), நீங்கள் பயன்படுத்த வேண்டியது GROUP BY முக்கியச் சொல்லாகும். GROUP BY என்ற முக்கியச் சொல்லை எந்தவொரு பரிமாண அளவுருவுடனும் இணைக்கலாம்.

GROUP BY என்பதுதான் ஒரு ஒற்றை மொத்த மதிப்பை, பிரிக்கப்பட்ட விவரங்களாக மாற்றுகிறது. இது இல்லாமல், SHOW total_sales என்பது ஒரு எண்ணை வழங்கும். GROUP BY product_titleமூலம், அதே அளவீடானது ஒவ்வொரு தயாரிப்புக்கும் பிரிக்கப்படுகிறது, எனவே எது உண்மையில் செயல்திறனை இயக்குகிறது என்பதை நீங்கள் கண்டறியலாம்.

எடுத்துக்காட்டாக, பில்லிங் நாடு மற்றும் பிராந்தியத்தின் அடிப்படையில் மொத்த விற்பனையைக் குழுவாக்கும் வினவலானது இவ்வாறு எழுதப்படும்:

FROM sales
  SHOW total_sales
  GROUP BY billing_country, billing_region

மாதத்தின் அடிப்படையில் மொத்த விற்பனையைக் காட்ட, நேரப் பரிமாணத்தைப் பயன்படுத்தும் மற்றொரு எடுத்துக்காட்டு வினவல் இதோ:

FROM sales
  SHOW total_sales
  GROUP BY month

விற்பனை இல்லாத மாதங்களை இந்த வினவல் வழங்காது. ஒரு முழுமையான, தடையற்ற காலகட்டத்தை வழங்கும் வினவல் உங்களுக்கு வேண்டுமானால், TIMESERIES முக்கியச் சொல்லைப் பயன்படுத்தவும்.

FROM sales
  SHOW total_sales
  TIMESERIES month
  SINCE last_year UNTIL today

நேரப் பரிமாணங்கள்

உங்கள் தரவைக் குழுவாக்க நீங்கள் பயன்படுத்தக்கூடிய நேரப் பரிமாணங்கள் இவை:

விநாடி, நிமிடம் அல்லது வாரத்தின் நாள் போன்ற ShopifyQL நேரப் பரிமாணங்களின் பட்டியல்.
ஆப்பரேட்டர்விளக்கம்
secondமணிநேரத்தின் விநாடிகளின்படி குழுவாக்குதல்.
minuteமணிநேரத்தின் நிமிடங்களின்படி குழுவாக்குதல்.
hourநாள்காட்டி நாளின் மணிநேரத்தின்படி குழுவாக்குதல்.
dayநாள்காட்டி நாளின்படி குழுவாக்குதல்.
weekநாள்காட்டி வாரத்தின்படி குழுவாக்குதல்.
monthநாள்காட்டி மாதத்தின்படி குழுவாக்குதல்.
quarterநாள்காட்டி காலாண்டின்படி குழுவாக்குதல்.
yearநாள்காட்டி ஆண்டின்படி குழுவாக்குதல்.
hour_of_day24 மணிநேரத்தின்படியான பூஜ்ஜிய அடிப்படையிலான குழுவாக்கம் (0, 1, ..., 23).
day_of_weekதிங்கள்கிழமைக்கான 0 முதல் ஞாயிற்றுக்கிழமைக்கான 6 வரையிலான, வாரத்தின் நாளின்படியான பூஜ்ஜிய அடிப்படையிலான குழுவாக்கம்.
week_of_year1 முதல் 52 வரையிலான அல்லது 53ஆவது வாரத்தைக் கொண்டுள்ள ஆண்டுகளில் 1 முதல் 53 வரையிலான, ஆண்டின் வாரத்தின்படியான குழுவாக்கம்.
month_of_yearஆண்டின் மாதத்தின்படியான குழுவாக்கம் (1, 2, ..., 12).

TOP N

நீங்கள் உங்கள் அறிக்கை காட்சிப்படுத்தலில் தனிப்பயன் எண்ணிக்கையிலான உருப்படிகளைக் காட்ட, TOP N அளபுருவைப் பயன்படுத்தலாம்; இதில் N என்பது காட்டப்படும் உருப்படிகளின் எண்ணிக்கையாகும். N என்பது ஒரு நேர்மறை முழு எண்ணாக இருக்க வேண்டும்.

வினவலின் ஒரு பகுதியாக, நீங்கள் TOP என்பதையும், பின்னர் உருப்படிகளின் எண்ணிக்கையையும் ஒரு வகைப்பாட்டுப் பரிமாணத்தையும் சேர்க்கலாம்; பல பரிமாணங்கள் இருந்தால் அவற்றை ஒரு காற்புள்ளியால் பிரிக்க வேண்டும். வகைப்பாட்டுப் பரிமாணங்கள் என்பவை தயாரிப்புகள், சேனல்கள் அல்லது பிராந்தியங்கள் போன்ற நேரத்துடன் தொடர்பற்ற பரிமாணங்களாகும். N என்பதில் சேர்க்கப்படாத உருப்படிகள் காட்சிப்படுத்தல் மற்றும் தரவு அட்டவணையில் "மற்றவை" எனக் குழுவாக்கப்படும். histogram அல்லது list போன்ற சில காட்சிப்படுத்தல் வகைகளுக்கு இவற்றால் குழுவாக்குவது ஆதரிக்கப்படாது: TOP N அளபுருக்கள்.

இந்த எடுத்துக்காட்டில், கடந்த 30 நாள்களுக்கான ஒவ்வொரு நாளின் முதல் 5 தயாரிப்புகளைக் காட்டுகிறீர்கள்; மீதமுள்ள உருப்படிகள் "மற்றவை" எனக் குழுவாக்கப்படும்:

FROM sales
  SHOW gross_sales
  GROUP BY day, TOP 5 product_title WITH GROUP_TOTALS, TOTALS, CURRENCY 'USD'
  TIMESERIES day
  SINCE startOfDay(-30d) UNTIL today
  ORDER BY day ASC, gross_sales DESC, product_title ASC
VISUALIZE gross_sales

நீங்கள் ஒன்றுக்கு மேற்பட்ட TOP N அளபுருவை ஓர் ஒற்றை GROUP BY அறிக்கையில் சேர்க்கலாம்.

பயன்படுத்தப்படும் தரவரிசை முறைமையுடன் மீதமுள்ள உருப்படிகள் எப்படிக் காட்டப்பட வேண்டும் என்பதைத் தனிப்பயனாக்க, TOP N அளபுருவுக்கு கூடுதல் முக்கியச் சொற்களைச் சேர்க்கலாம்:

  • ONLY TOP N: தரவுத்தொகுப்பில் உள்ள மீதமுள்ள உருப்படிகளை "மற்றவை" எனக் குழுவாக்காமல், காட்சிப்படுத்தல் மற்றும் தரவு அட்டவணையிலிருந்து மறைத்து N எண்ணிக்கையிலான உருப்படிகளை மட்டுமே காட்டும்.
  • TOP N {dimension} OVERALL: குறிப்பிட்ட தேதி வரம்பில் (ஒட்டுமொத்தத் தரவரிசை) உள்ள முதல் N எண்ணிக்கையிலான உருப்படிகளைக் குறிப்பிட்ட பரிமாணத்தால் குழுவாக்கிக் காட்டும். OVERALL என்பது, GROUP BY அறிக்கையிலுள்ள முதல் பரிமாணத்தில் எந்தவொரு தாக்கத்தையும் ஏற்படுத்தாது. மீதமுள்ள உருப்படிகளை மறைக்க நீங்கள் ONLY முக்கியச் சொல்லையும் சேர்க்கலாம். தரவுத்தொகுப்பின் வரிசையாக்க முறைமை இன்னமும் இதனாலேயே தீர்மானிக்கப்படும்: ORDER BY முக்கியச் சொல்லிலும் சேர்க்கப்பட வேண்டும்.

இந்த எடுத்துக்காட்டில், கடந்த 30 நாள்களுக்கான ஒவ்வொரு நாளின் முதல் 5 தயாரிப்புகளை மட்டுமே காட்டுகிறீர்கள்; மீதமுள்ள உருப்படிகள் காட்சிப்படுத்தல் மற்றும் தரவு அட்டவணையிலிருந்து முற்றிலுமாக மறைக்கப்படும்:

FROM sales
  SHOW gross_sales
  GROUP BY day, ONLY TOP 5 product_title WITH GROUP_TOTALS, TOTALS, CURRENCY 'USD'
  TIMESERIES day
  SINCE startOfDay(-30d) UNTIL today
  ORDER BY day ASC, gross_sales DESC, product_title ASC
VISUALIZE gross_sales

இந்த எடுத்துக்காட்டில், கடந்த 30 நாள்களின் முதல் 5 தயாரிப்புகளை நாளின்படியான குழுவாகக் காட்டுகிறீர்கள்; மீதமுள்ள உருப்படிகள் மறைக்கப்படும்:

FROM sales
  SHOW gross_sales
  GROUP BY day, ONLY TOP 5 product_title OVERALL WITH GROUP_TOTALS, TOTALS, CURRENCY 'USD'
  TIMESERIES day
  SINCE startOfDay(-30d) UNTIL today
  ORDER BY day ASC, gross_sales DESC, product_title ASC
VISUALIZE gross_sales

சரியாக LIMITஎன்பதைப் போலவே TOP N அளபுரு உங்கள் தரவு அட்டவணை மற்றும் காட்சிப்படுத்தலில் உள்ள உருப்படிகளின் எண்ணிக்கையைப் புதுப்பிக்கும். தரவு அட்டவணையைப் பாதிக்காமல் உங்கள் அறிக்கை காட்சிப்படுத்தலில் உள்ள உருப்படிகளின் எண்ணிக்கையைத் தனிப்பயனாக்க, இதைப் பயன்படுத்தவும்: VISUALIZE {metric} MAX N அளபுரு.

இந்த எடுத்துக்காட்டில், கடந்த 30 நாள்களுக்கான ஒவ்வொரு நாளின் முதல் 5 தயாரிப்புகளைக் காட்டுகிறீர்கள்; மீதமுள்ள உருப்படிகள் அட்டவணையில் தொடர்ந்து பட்டியலிடப்பட்டிருக்கும்:

FROM sales
  SHOW gross_sales
  GROUP BY day, product_title WITH GROUP_TOTALS, TOTALS, CURRENCY 'USD'
  TIMESERIES day
  SINCE startOfDay(-30d) UNTIL today
  ORDER BY day ASC, gross_sales DESC, product_title ASC
VISUALIZE gross_sales MAX 5

CLUSTER

நீங்கள் CLUSTER மாற்றியை ஒரு GROUP BY அறிக்கையில் பயன்படுத்தி அருகிலுள்ள முகவரிகளைப் புவியியல் ரீதியான கிளஸ்டர்களாகக் குழுவாக்கலாம். உங்கள் அளவீட்டின்படி அளவிடப்படும் பபிளாக ஒவ்வொரு கிளஸ்டரும் வரையப்பட்டிருக்கும் பபிள் வரைபடக் காட்சிப்படுத்தலில் கிளஸ்டர் முடிவுகளைக் காட்டலாம்.

CLUSTER என்பதானது shipping_address மற்றும் billing_address பரிமாணங்களுடன் செயல்படும், இவை sales மற்றும் payments போன்ற தரவுத்தொகுப்புகளில் கிடைக்கின்றன. இந்த முகவரிப் பரிமாணங்களை CLUSTERகொண்டு மட்டுமே குழுவாக்க முடியும். இது இல்லாமல் நீங்கள் shipping_address மூலம் குழுவாக்கினால், வினவலானது 'shipping_address' can only be grouped with CLUSTER எனும் பிழையை வழங்கும்.

வடிகட்டிப் பேனலில் முகவரிப் பரிமாணங்கள் கிடைக்காது. ஒரு வினவலில் இடத்தின் மூலம் வடிகட்ட, ஒரு முகவரியின் ஆயத்தொலைவுப் புலங்களை WHERE-இல் பயன்படுத்தவும் (உதாரணத்திற்கு, shipping_address.latitude மற்றும் shipping_address.longitude). வினவலில் புலப்படும் வரைபடப் பகுதியைச் சேர்க்க, இந்தப் புலங்களை ஒரு பபிள் வரைபடம் பயன்படுத்தும்.

இந்த உதாரணத்தில், கடந்த 30 நாட்களுக்கான மொத்த விற்பனையை அருகிலுள்ள ஷிப்பிங் முகவரிகளின் கிளஸ்டர்களாகக் குழுவாக்கி, ஒரு பபிள் வரைபடத்தில் காட்டுகிறீர்கள்:

FROM sales
  SHOW total_sales
  GROUP BY CLUSTER shipping_address WITH TOTALS
  SINCE -30d UNTIL today
VISUALIZE total_sales TYPE bubble_map

ஒவ்வொரு கிளஸ்டரும் shipping_address__cluster.size போன்ற உருவாக்கப்பட்ட முகவரி எண்ணிக்கைக்கான புலத்தை உள்ளடக்கியிருக்கும், இது தரவு அட்டவணையில் ஷிப்பிங் முகவரி எண்ணிக்கை எனக் காட்டப்படும். கிளஸ்டரில் உள்ள வெவ்வேறான வரைபட இடங்களின் எண்ணிக்கையே இந்த எண்ணிக்கையாகும், எனவே ஒரே இடத்தில் உள்ள பல முகவரிகள் 1 முகவரியாகவே கணக்கிடப்படும். இந்த முகவரி எண்ணிக்கைக்கான புலத்தை நீங்கள் ORDER BY மற்றும் HAVING-இல் குறிப்பிடலாம். உதாரணத்திற்கு, அதிக இடங்களைக் கொண்டுள்ள கிளஸ்டர்களை முதலில் பட்டியலிட, உங்கள் வினவலில் ORDER BY shipping_address__cluster.size DESC என்பதைச் சேர்க்கவும்.

நீங்கள் CLUSTER என்பதை TOP N உடன் இணைத்து மிகப் பெரிய கிளஸ்டர்களை மட்டுமே பெறலாம் (உதாரணத்திற்கு, GROUP BY ONLY TOP 10 CLUSTER shipping_address). நீங்கள் TOP N ஆனது, இந்த அளபுரு இல்லாமல் இடம்பெற்றிருந்தால்: ONLYஎன்பதைப் பயன்படுத்தினால், மீதமுள்ள கிளஸ்டர்கள் மற்றவை எனும் வரிசையில் இணைக்கப்படும். மற்றவை வரிசை தரவு அட்டவணையில் மட்டுமே காட்டப்படும், ஏனெனில் அது இணைக்கும் கிளஸ்டர்கள் வரைபடத்தில் வேறுபட்ட பகுதிகளில் இருக்கலாம்.

ஒரு பபிள் வரைபடம், கிளஸ்டர் செய்யப்பட்ட முகவரியுடன் மற்ற பரிமாணங்களையும் காட்டலாம். CLUSTER என்பதற்கு முன்பாக GROUP BY அறிக்கையில் வரும் ஒரு பரிமாணம் ஒவ்வொரு மதிப்பையும் அதற்கே உரிய நிறத்தில் வரையும் (உதாரணத்திற்கு, GROUP BY product_title, CLUSTER shipping_address). அதற்குப் பின் வரும் ஒரு பரிமாணம், ஒவ்வொரு கிளஸ்டரிலும் ஒவ்வொரு மதிப்பிற்கும் ஒரு வரிசையை வழங்கும் (உதாரணத்திற்கு, GROUP BY CLUSTER shipping_address, day). மற்றொரு பரிமாணத்தின் மூலம் பபிள் வரைபடம் குழுவாக்கும்போது, தற்போதைய ஜூம் அளவில் பெரிய பபிளுக்குள் மையம் வரையப்பட்டிருக்கும் பபிள் அதனுள் ஒன்றிணைக்கப்படும். அந்தப் பெரிய பபிள் மொத்த மதிப்பிற்குப் பதிலாக தனக்குரிய மதிப்பையே வைத்திருக்கும்; அதன் டூல்டிப்பில், அதில் இடம்பெற்றுள்ள வரிசைகள் பட்டியலிடப்பட்டிருக்கும். இதற்குப் பதிலாக ஒவ்வொரு கிளஸ்டரின் மொத்த மதிப்பிற்கும் 1 பபிளை வரைய, WITH GROUP_TOTALS என்பதைச் சேர்க்கவும் (உதாரணத்திற்கு, GROUP BY CLUSTER shipping_address, product_title WITH GROUP_TOTALS).

TIMESERIES

நீங்கள் TIMESERIES முக்கியச் சொல்லைப் பயன்படுத்தி ஒரு நேரப் பரிமாணத்தின்படி முடிவுகளைக் குழுவாக்கலாம், குறிப்பிட்ட காலத்தின் அளவீடுகளைப் பார்க்கலாம், மேலும் தரவு இல்லாத காலகட்டங்களை வெற்று மதிப்புகளாகத் திருப்பலாம்.

இந்த எடுத்துக்காட்டில், கடந்த 15 நாள்களில் விடுபட்ட மொத்த விற்பனைத் தரவைப் பேக்ஃபில் செய்கிறீர்கள் (backfilling):

FROM sales
  SHOW total_sales
  GROUP BY product_title, billing_country
  TIMESERIES day
  SINCE -15d

TIMESERIES என்பதற்கான இயல்புநிலைத் தேதி வரம்புகள்

உங்கள் வினவலில் TIMESERIES ஆனது, இந்த அளபுரு இல்லாமல் இடம்பெற்றிருந்தால்: SINCE அல்லது DURING. அப்படியெனில், நீங்கள் குழுவாக்கும் நேரப் பரிமாணத்தின் அடிப்படையில் ஓர் இயல்புநிலைத் தொடக்கத் தேதி பயன்படுத்தப்படும். நீங்கள் இதைக் குறிப்பிட்டால் ஒழிய, நடப்பு நாளின் இறுதி வரை வரம்பு பொருந்தும்: UNTIL மதிப்பு.

TIMESERIES வினவலுக்கு ஒவ்வொரு ShopifyQL நேரப் பரிமாணமும் பயன்படுத்தும் இயல்புநிலைத் தொடக்கத் தேதிகளின் பட்டியல்.
நேரப் பரிமாணம்இயல்புநிலைத் தொடக்கத் தேதி
secondstartOfMinute(-1min)
minutestartOfHour(-1h)
hourstartOfHour(-24h)
daystartOfDay(-30d)
weekstartOfWeek(-4w)
monthstartOfMonth(-3m)
quarterstartOfQuarter(-4q)
yearstartOfYear(-3y)
hour_of_daystartOfDay(-3d)
day_of_weekstartOfWeek(-4w)
week_of_yearstartOfYear(-1y)
month_of_yearstartOfYear(-1y)

TIMESERIES மற்றும் நெடுவரிசைகளின் வரிசை

நெடுவரிசைகளின் வரிசையானது மாறக்கூடும்; இது TIMESERIES தரப்பட்டுள்ளதா மற்றும் இவற்றில் ஏதேனும் ஒன்றில் உள்ளதா என்பதைப் பொறுத்தது: GROUP BY அல்லது SHOW மதிப்புகள்.

TIMESERIES என்பதற்கான எடுத்துக்காட்டுகளும் ShopifyQL இல் GROUP BY அல்லது SHOW மூலம் நெடுவரிசைகளின் வரிசை எப்படிக் காட்டப்படும் என்பதற்கான எடுத்துக்காட்டுகளும்.
TIMESERIESSHOWGROUP BYமுடிவு
தரப்பட்டுள்ளதுஇல்லைஇல்லைஇந்த TIMESERIES என்பது முதல் பரிமாணமாகும்.
தரப்பட்டுள்ளதுஇல்லைஉள்ளதுநேரப் பரிமாணங்களின் நிலையானது, இதில் உள்ள அவற்றின் நிலையை வைத்து வரையறுக்கப்படும்: GROUP BY.
தரப்பட்டுள்ளதுஉள்ளதுஉள்ளதுநேரப் பரிமாணங்களின் நிலையானது, இதில் உள்ள அவற்றின் நிலையை வைத்து வரையறுக்கப்படும்: SHOW.
தரப்படவில்லைஇல்லைஉள்ளதுநேரப் பரிமாணங்களின் நிலையானது, இதில் உள்ள அவற்றின் நிலையை வைத்து வரையறுக்கப்படும்: GROUP BY. தரவு பேக்ஃபில் செய்யப்படவில்லை.
தரப்படவில்லைஉள்ளதுஉள்ளதுநேரப் பரிமாணங்களின் நிலையானது, இதில் உள்ள அவற்றின் நிலையை வைத்து வரையறுக்கப்படும்: SHOW. தரவு பேக்ஃபில் செய்யப்படவில்லை.
தரப்படவில்லைஉள்ளதுஇல்லைஇது ஒரு தொடரியல் பிழையைத் தூண்டுகிறது; ஏனெனில் SHOW என்பதானது இதில் உள்ள பரிமாணங்களை மட்டுமே குறிப்பிட முடியும்: GROUP BY.

HAVING

சரியாக WHERE, நீங்கள் HAVING முக்கியச் சொல்லைப் பயன்படுத்தி ஒரு வினவலின் முடிவுகள் குழுவாக்கப்பட்ட பிறகு அவற்றை வடிகட்டலாம். வடிப்பானில் ஒரு நிபந்தனை இருக்கலாம்; ஆனால் அந்த நிபந்தனையை ஒப்பீட்டு இயக்கிகள் (பெரியது > போன்றவை) மற்றும் தர்க்கரீதியான இயக்கிகள் (இது போன்றவை: AND அல்லது NOT) ஆகிய இரண்டாலும் திருத்த முடியும். இதைப் போல இல்லாமல்: WHERE முக்கியச் சொல், HAVING என்பதானது மறுபெயர்கள், தொகுப்புச் செயல்பாடுகள் மற்றும் குழுவாக்க நெடுவரிசைகளைக் குறிப்பிட முடியும்.

HAVING என்பதற்கு உங்கள் வினவலில் இந்த உட்பிரிவு இடம்பெற்றிருக்க வேண்டும்: GROUP BY அல்லது TIMESERIES உட்பிரிவு; ஏனெனில் HAVING என்பதானது ஒரு வினவலின் முடிவுகள் இதனால் குழுவாக்கப்பட்ட பிறகு அவற்றை வடிகட்டுகிறது: GROUP BY அல்லது TIMESERIES.

இந்த எடுத்துக்காட்டில், மொத்த விற்பனை 1000-ஐ விட அதிகமாகவும் 5000-ஐ விடக் குறைவாகவும் உள்ள ஒவ்வொரு தயாரிப்புக்கான மொத்த விற்பனையை வடிகட்டுகிறீர்கள்:

FROM sales
  SHOW total_sales
  GROUP BY product_title
  HAVING total_sales > 1000 AND total_sales < 5000

இதைக் கொண்டு வடிகட்டுதல்: HAVING ஏற்கப்பட்ட முக்கியச் சொற்களுக்குச் சில வரம்புகளைக் கொண்டுள்ளது: totals, group totals, comparisons, percent changes மற்றும் running totals ஆகியவை ஒரு HAVING நிலையில் செல்லுபடியாகாது. மேலும் ஒன்றைக் குறிப்பிடும்போது 'comparison_total_sales__previous_year' is not allowed in the HAVING clause என்பது போன்ற பிழையை வழங்கும். அட்ரிபியூட் செய்யப்பட்ட அளவீடுகள் செல்லுபடியாகும், அதாவது total_sales__first_click ஒரு அட்ரிபியூஷன் மாடல் பயன்படுத்தப்படும்போது.

WITH

இந்த WITH முக்கியச் சொல் வேறு சில ShopifyQL முக்கியச் சொற்களின் செயல்பாட்டை மாற்றியமைக்கும். பின்வரும் மாற்றியமைத்தல்களை நீங்கள் பயன்படுத்தலாம்:

  • TOTALS: அளவீடுகள் ஏதேனும் பரிமாணத்தால் பிரிக்கப்படுவதற்கு முன்பு அவற்றின் உயர்மட்டச் சுருக்கத்தை வழங்கும்.
  • GROUP_TOTALS: குழுவாக்கப்பட்டத் தொகுப்பு இருக்கும்போது, அனைத்துத் துணைக்குழுக்களுக்கான மொத்தத்தை வழங்கும்.
  • PERCENT_CHANGE: இதில் உள்ள ஒவ்வொரு ஒப்பீட்டு அளவீட்டுக்குமான சுருக்க வரிசையிலும் சதவீத மாற்ற மதிப்பைச் சேர்க்கும்: COMPARE TO.
  • CURRENCY: தேர்ந்தெடுக்கப்பட்ட நாணயத்தில் தரவைக் காட்டும்.
  • TIMEZONE: தேர்ந்தெடுக்கப்பட்ட IANA நேர மண்டலத்தில் நேர அடிப்படையிலான முடிவுகளைக் கணக்கிடும்.
  • ஏதேனும் ஒரு அட்ரிபியூஷன் மாடல், அதாவது LAST_CLICK_ATTRIBUTION, FIRST_CLICK_ATTRIBUTION, அல்லது ANY_CLICK_ATTRIBUTION: மார்க்கெட்டிங் பரிமாணத்தின் மூலம் விற்பனை அளவீடுகள் பிரிக்கப்படும்போது, அவற்றுக்கு மார்க்கெட்டிங் அட்ரிபியூஷன் மாடல்களைப் பயன்படுத்தும். அட்ரிபியூட் செய்யப்பட்ட ஒவ்வொரு அளவீடும் அது அடிப்படையாகக் கொண்ட அளவீட்டைப் பதிலீடு செய்யும்.
  • CUMULATIVE_VALUES: ஒவ்வொரு காலக்கட்டத்துக்குமான தனிப்பட்ட மதிப்புகளாகக் காட்டாமல், அளவீட்டை ஒரு நடப்பு மொத்தமாகக் காட்டும்.

TOTALS

இந்த TOTALS மாற்றியானது, அளவீடுகள் ஏதேனும் பிற பரிமாணத்தால் பிரிக்கப்படுவதற்கு முன்பு, அவற்றின் உயர்மட்டச் சுருக்கத்தை வழங்கும். நீங்கள் WITH TOTALSஎன்பதைப் பயன்படுத்தும்போது, தரவு அட்டவணையானது முடிவுகளின் தொடக்கத்தில் சுருக்க வரிசையில், வினவல் உள்ளடக்கிய தேதிக்கான வரம்புடன் லேபிளிடப்பட்ட மொத்தங்களைக் காட்டும்.

கூட்டக்கூடிய அளவீடுகள், அதாவது net_salesஆகியவை, முழு முடிவுத் தொகுப்பிலும் கூட்டப்படும். விகிதம் மற்றும் சதவீத அளவீடுகள், அதாவது average_order_valueஆகியவை, குழுவாக்கப்பட்ட வரிசைகளிலிருந்து கூட்டப்படுவதற்குப் பதிலாக, முழு முடிவுத் தொகுப்பிலும் மறுகணக்கீடு செய்யப்படும்.

எடுத்துக்காட்டாக, இந்த வினவல் தினசரி விற்பனை அளவீடுகளை ஒரு சுருக்க வரிசையுடன் காட்டுகிறது:

FROM sales
  SHOW gross_sales, net_sales
  TIMESERIES day WITH TOTALS

இந்த வினவல் இது போன்றதொரு அறிக்கையை வழங்கக்கூடும்:

WITH TOTALS என்பதைப் பயன்படுத்தும் விற்பனையின் எடுத்துக்காட்டு ShopifyQL அட்டவணை.
நாள்மொத்த விற்பனைநிகர விற்பனை
ஜன 1-3, 2024615
2024-01-0114
2024-01-0225
2024-01-0336

GROUP_TOTALS

இந்த GROUP_TOTALS மாற்றியானது, ஒரு வினவல் குறைந்தது 2 பரிமாணங்கள் வாரியாகக் குழுவாக்கும்போது, ஒவ்வொரு குழுவிற்கும் ஒரு துணை மொத்தத்தைக் கணக்கிடும். முழுமையான தொகுப்பைத் தவிர்த்து, குழுவாக்கப்பட்ட ஒவ்வொரு பரிமாணத் தொகுப்பிற்கும் ஒரு துணை மொத்தத்தை ShopifyQL கணக்கிடும். 2 பரிமாணங்கள் வாரியாகக் குழுவாக்குவது 1 நிலை துணை மொத்தங்களையும், 3 பரிமாணங்கள் வாரியாகக் குழுவாக்குவது 2 நிலைகளையும் உருவாக்கும்.

துணை மொத்தங்களைக் காட்ட, அவை குழுவாக்கப்பட்டுள்ள பரிமாணங்களின் அடிப்படையிலும் உங்கள் வினவல் வரிசைப்படுத்தப்பட வேண்டும். கடைசியானதைத் தவிர்த்து, குழுவாக்கப்பட்ட ஒவ்வொரு பரிமாணமும் இதில் சேர்க்கப்பட வேண்டும்: ORDER BYஅல்லது இதிலுள்ள பரிமாணமாக இருக்க வேண்டும்: TIMESERIES. அந்தத் தேவையைக் பூர்த்தி செய்யும் போது, தரவு அட்டவணையானது முடிவுகளைக் குழுவாக்கி, ஒவ்வொரு குழுவிற்கும் ஒரு மொத்தம் வரிசையைச் சேர்க்கும். அது பூர்த்தியாகாத போது, தரவு அட்டவணை அப்படியே இருக்கும், மேலும் துணை மொத்தங்கள் காட்டப்படாது.

ஒவ்வொரு துணை மொத்தமும் உருவாக்கப்பட்ட பெயரைக் கொண்டிருக்கும், அது அளவீட்டையும் அது மொத்தமாக்கும் பரிமாணங்களையும் இணைக்கும்:

  • {metric_name}__{first_dimension}_totals, எடுத்துக்காட்டாக total_sales__billing_country_totals
  • {metric_name}_{first_dimension}{second_dimension}_totals, இது ஒரு வினவல் 3 பரிமாணங்கள் வாரியாகக் குழுவாக்கும்போது உருவாக்கப்படும்

இந்தப் பெயர்களை நீங்கள் இங்கு குறிப்பிடலாம்: ORDER BY மற்றும் VISUALIZE, துணை மொத்தங்கள் காட்டப்பட்டாலும் காட்டப்படாவிட்டாலும் சரி.

தன்னிச்சையாகவே, GROUP_TOTALS சுருக்க வரிசையைக் காலியாக விட்டுவிடும், ஏனென்றால் ஒட்டுமொத்தமாக எந்த மொத்தமும் கணக்கிடப்படாது. உங்களுக்கு ஒட்டுமொத்தச் சுருக்க வரிசையும் தேவைப்படும்போது, GROUP_TOTALS என்பதை இதனுடன் சேர்த்துப் பயன்படுத்தவும்: TOTALS.

எடுத்துக்காட்டாக, இந்த வினவல் ஒவ்வொரு நாளுக்குமான துணை மொத்தத்துடன், ஒவ்வொரு நாளிலும் ஒவ்வொரு பில்லிங் நாட்டிற்குமான மொத்த விற்பனையைக் காட்டுகிறது. வினவல் இதன் மூலம் வரிசைப்படுத்துகிறது: day, இது துணை மொத்தங்கள் கணக்கிடப்படுவதற்கான குழுவாக்கப்பட்ட பரிமாணமாகும், எனவே துணை மொத்தங்கள் காட்டப்படும்:

FROM sales
  SHOW total_sales
  GROUP BY day, billing_country WITH TOTALS, GROUP_TOTALS
  SINCE -30d
  ORDER BY day ASC

இந்த வினவல் இது போன்றதொரு அறிக்கையை வழங்கக்கூடும்:

GROUP_TOTALS என்பதைப் பயன்படுத்தும் விற்பனையின் எடுத்துக்காட்டு ShopifyQL அட்டவணை.
நாள்பில்லிங் நாடுமொத்த விற்பனை
ஜூன் 1-30, 2024-150
ஜூன் 1, 2024மொத்தம்90
ஜூன் 1, 2024கனடா50
ஜூன் 1, 2024அமெரிக்கா40
ஜூன் 2, 2024மொத்தம்60
ஜூன் 2, 2024கனடா60

முதல் வரிசை என்பது சுருக்க வரிசையாகும், இதைச் சேர்ப்பது TOTALS ஆகும். ஒவ்வொரு மொத்தம் வரிசையும் அது குழுவாக்கும் வரிசைகளின் நாளுக்கான துணை மொத்தமாகும்.

இந்த வினவல் இதன் மூலம் வரிசைப்படுத்துவதால்: day, தரவு அட்டவணையானது ஒவ்வொரு நாளுக்குமான மொத்தம் வரிசையைக் காட்டும்.

PERCENT_CHANGE

இந்த PERCENT_CHANGE மாற்றியானது, நீங்கள் என்பதைப் பயன்படுத்தும்போது ஒவ்வொரு ஒப்பீட்டு அளவீட்டுக்குமான சதவீத மாற்ற மதிப்பைச் சேர்க்கும்COMPARE TO. ஒப்பீட்டு மதிப்பைக் கொண்டுள்ள ஒவ்வொரு வரிசைக்கும் ஒரு சதவீத மாற்றம் கணக்கிடப்படும், ஆனால் தரவு அட்டவணையானது அது ஒப்பிடும் 2 காலக்கட்டங்களுக்கான மதிப்புகளுடன் சேர்த்து அதைச் சுருக்க வரிசையில் மட்டுமே காட்டும். இதையும் சேர்க்கவும் TOTALS சதவீத மாற்றம் காட்டப்பட வேண்டுமென நீங்கள் விரும்பும்போது, ஏனென்றால் TOTALS என்பதுதான் சுருக்க வரிசையைச் சேர்க்கிறது.

உங்கள் அறிக்கையிடல் காலக்கட்டத்தில் தற்போதைய தேதி இடம்பெற்றிருக்கும்போது, ஒவ்வொரு காலக்கட்டமும் அதற்கான நேர அலகில் அதே புள்ளி வரை மட்டுமே அளவிடப்படும், எனவே ஒரு பகுதியளவு தற்போதைய காலக்கட்டமானது இதுவரையிலான ஒரு சமமான காலக்கட்டத்துடன் ஒப்பிடப்படும். எடுத்துக்காட்டாக, ஒரு மாதத்தின் 17ஆம் தேதியன்று, ஒவ்வொரு ஒப்பீட்டு மாதமும் அதன் 17ஆம் தேதி வரை அளவிடப்படும்.

ஒவ்வொரு சதவீத மாற்றத்திற்கும் உருவாக்கப்பட்ட பெயர் இருக்கும், இது அளவீட்டையும் ஒப்பீட்டு கால அளவையும் ஒருங்கிணைக்கும்:

  • இதைப் போன்ற தொடர்புடைய ஒப்பீடு, COMPARE TO previous_year, இதைச் சேர்க்கும் percent_change_net_sales__previous_year.
  • இதைப் போன்ற தேதி செயல்பாட்டு ஒப்பீடு, COMPARE TO startOfQuarter(-3q), இதைச் சேர்க்கும் percent_change_total_sales__startOfQuarter_sub_3q, இதில் ஒவ்வொரு கழித்தல் குறியும் இப்படி மாறும் sub.

தேதி ஒப்பீடு இல்லாமல், இந்த மாற்றி எந்தவொரு சதவீத மாற்ற நெடுவரிசைகளையும் சேர்க்காது.

சதவீத மாற்றத்தைக் கணக்கிடப் பயன்படுத்தப்படும் சூத்திரம்: (base_column - comparison_column) * 100 / abs(comparison_column). நேர்மறை மதிப்பு என்பது அடிப்படை கால அளவு ஒப்பீட்டு கால அளவை விட அதிகமாக இருப்பதையும், எதிர்மறை மதிப்பு என்பது அடிப்படை கால அளவு ஒப்பீட்டு கால அளவை விடக் குறைவாக இருப்பதையும் குறிக்கும்.

உதாரணமாக, இந்த வினவல் SINCE மற்றும் COMPARE TO என்பதைப் பயன்படுத்தி முந்தைய கேலெண்டர் மாதத்தின் ஒரு நாளுக்கான நிகர விற்பனையை முந்தைய ஆண்டின் அதே மாதத்துடன் ஒப்பிடுகிறது, இதில் சுருக்க வரிசையில் சதவீத மாற்றமும் இருக்கும்:

FROM sales
  SHOW net_sales
  TIMESERIES day WITH TOTALS, PERCENT_CHANGE
  SINCE startOfMonth(-1m) UNTIL endOfMonth(-1m)
  COMPARE TO previous_year

அறிக்கையானது நாள் நெடுவரிசையையும் நிகர விற்பனை நெடுவரிசையையும் காண்பிக்கும். ஒவ்வொரு செல்லிலும் அறிக்கை-கால அளவின் மதிப்பும் ஒப்பீட்டு-கால அளவின் மதிப்பும் ஒன்றாக அடுக்கப்பட்டிருக்கும், மேலும் சுருக்க வரிசையில் சதவீத மாற்றம் இடம்பெறும்.

CURRENCY

இந்த CURRENCY மாற்றி அறிக்கையிலுள்ள தரவைத் தேர்ந்தெடுக்கப்பட்ட நாணயத்தில் காண்பிக்கும். நாணய அளவீடுகள் ஒற்றை மேற்கோள் குறிகளுக்குள் இருக்க வேண்டும், மேலும் தொடர்புடைய 3-எழுத்து நாணயக் குறியீட்டைப் பயன்படுத்த வேண்டும்.

உதாரணமாக, இந்த வினவல் CURRENCY என்பதைப் பயன்படுத்தி கனடிய டாலர்களில் (CAD) நிகர விற்பனைத் தரவைக் காண்பிக்கலாம்.

FROM sales
  SHOW net_sales
  TIMESERIES day WITH CURRENCY 'CAD'

TIMEZONE

இந்த TIMEZONE மாற்றி உங்கள் அறிக்கையிலுள்ள நேர அடிப்படையிலான முடிவுகளைத் தேர்ந்தெடுக்கப்பட்ட நேரமண்டலத்தில் கணக்கிடும், இதில் தேதி செயல்பாடுகள் தீர்க்கப்படும் எல்லைகளும் அடங்கும். நேரமண்டலங்கள் ஒற்றை மேற்கோள் குறிகளுக்குள் இருக்க வேண்டும், மேலும் இதைப் போல சரியான இணையம் ஒதுக்கிய எண்கள் ஆணையத்தின் (IANA) நேரமண்டலப் பெயரைப் பயன்படுத்த வேண்டும்: EST, UTC, அல்லது Europe/Paris.

உதாரணமாக, இந்த வினவல் TIMEZONE என்பதன் மூலம் இதில் ஒவ்வொரு நாள் எல்லையையும் தீர்க்கலாம் America/New_York நேரமண்டலம், இதனால் ஒரு நாளின் தொடக்கம் அல்லது முடிவிற்கு அருகில் நடக்கும் விற்பனைகள் எதிர்பார்த்த நாளில் சேர்க்கப்படும்.

FROM sales
  SHOW net_sales
  TIMESERIES day WITH TIMEZONE 'America/New_York'
  SINCE startOfMonth(-1m) UNTIL endOfMonth(-1m)

அட்ரிபியூஷன் மாடல்கள்

உங்கள் விற்பனை அளவீடுகளை நிலையான மார்க்கெட்டிங் அட்ரிபியூஷனுடன் காண்பிக்க, கிடைக்கும் எந்தவொரு அட்ரிபியூஷன் மாடலையும் மாற்றியாகச் சேர்க்கலாம். விற்பனை அளவீடு மற்றும் மார்க்கெட்டிங் பரிமாணம் ஆகிய இரண்டும் பயன்படுத்தப்படும்போது மட்டுமே இந்த விருப்பம் கிடைக்கும், மேலும் இது விற்பனை அளவீடுகளை மட்டுமே பாதிக்கும். இந்த நிபந்தனைகள் பூர்த்தியாகி, அட்ரிபியூஷன் மாடல் எதுவும் தேர்ந்தெடுக்கப்படாவிட்டால், அறிக்கைகள் இதில் இயல்புநிலையாக இருக்கும் LAST_CLICK_ATTRIBUTION.

நீங்கள் அட்ரிபியூஷன் மாடலைப் பயன்படுத்தும்போது, தகுதியான ஒவ்வொரு விற்பனை அளவீடும் அதன் அட்ரிபியூட் செய்யப்பட்ட பதிப்பால் மாற்றப்படும். அட்ரிபியூஷன் என்பது ஒரு WITH மாற்றி ஆகும், இது உங்கள் தரவு அட்டவணையில் உள்ள நெடுவரிசைகளை மாற்றுகிறது. புதிய நெடுவரிசைப் பெயரானது அளவீட்டுப் பெயரையும் மாடலுக்கான பின்னொட்டையும் இணைக்கும், மேலும் நெடுவரிசைத் தலைப்பானது மொத்த விற்பனை (கடைசி கிளிக்) என்பது போன்று மாடலைப் பெயரிடும். அளவீடு இதன் மூலம் மறுபெயரிடப்பட்டால் AS, அளவீட்டுப் பெயருக்குப் பதிலாக நெடுவரிசைப் பெயரில் மாற்றுப்பெயர் பயன்படுத்தப்படும்.

அளவீடு மாற்றப்படுவதால், வினவலின் எஞ்சிய பகுதியில் அசல் அளவீட்டுப் பெயர் செல்லுபடியாகாது. உதாரணமாக, இதில் அசல் அளவீட்டைக் குறிப்பிடுவது ORDER BY, VISUALIZE, அல்லது HAVING 'total_sales' is not allowed when applying attribution. Use: 'total_sales__last_click' என்பது போன்ற பிழையை வழங்கும். அதற்குப் பதிலாக அந்த முக்கியச் சொற்களில் அட்ரிபியூட் செய்யப்பட்ட பெயரைப் பயன்படுத்தவும்.

ShopifyQL அட்ரிபியூஷன் மாடல்களின் பட்டியல் மற்றும் தகுதியான விற்பனை அளவீடுகளுக்கு ஒவ்வொரு மாடலும் சேர்க்கும் நெடுவரிசைப் பெயர்ப் பின்னொட்டு.
அட்ரிபியூஷன் மாடல்நெடுவரிசைப் பின்னொட்டுஇதற்கான உதாரண நெடுவரிசை: total_sales
FIRST_CLICK_ATTRIBUTION__first_clicktotal_sales__first_click
LAST_CLICK_ATTRIBUTION__last_clicktotal_sales__last_click
LAST_NON_DIRECT_CLICK_ATTRIBUTION__last_non_direct_clicktotal_sales__last_non_direct_click
ANY_CLICK_ATTRIBUTION__any_clicktotal_sales__any_click
LINEAR_ATTRIBUTION__lineartotal_sales__linear

நீங்கள் ஒரே WITH கிளாஸில் ஒன்றுக்கும் மேற்பட்ட அட்ரிபியூஷன் மாடல்களைச் சேர்த்து மாடல்களைப் பக்கவாட்டில் ஒப்பிடலாம். ANY_CLICK_ATTRIBUTION ஒவ்வொரு டச்பாயிண்டுக்கும் முழு கிரெடிட்டையும் வழங்கும், எனவே இதன் அட்ரிபியூட் செய்யப்பட்ட மொத்தங்கள் அளவீட்டின் ஒட்டுமொத்த மதிப்பை விட அதிகமாக இருக்கலாம்.

உதாரணமாக, இந்த வினவல் LAST_CLICK_ATTRIBUTION என்பதைப் பயன்படுத்தி, கடைசி கிளிக்கில் அட்ரிபியூட் செய்யப்பட்ட பரிந்துரைக்கும் சேனலின்படி மொத்த விற்பனையைக் காண்பிக்கலாம், இது மொத்த விற்பனை (கடைசி கிளிக்) என்ற நெடுவரிசையைக் காண்பிக்கும்:

FROM sales
  SHOW total_sales
  GROUP BY ONLY TOP 5 referring_channel WITH TOTALS, LAST_CLICK_ATTRIBUTION
  SINCE startOfDay(-30d) UNTIL today
  ORDER BY total_sales__last_click DESC
VISUALIZE total_sales__last_click

அறிக்கைகளில் அட்ரிபியூஷன் மாடல்கள் பற்றி மேலும் அறிக.

CUMULATIVE_VALUES

நேரப்போக்கில் அளவீட்டைக் காண்பிக்கும்போது, ஒவ்வொரு காலகட்டத்திற்குமான தனிப்பட்ட மதிப்புகளாகக் காண்பிப்பதற்குப் பதிலாக அளவீட்டை நடப்பு மொத்தமாகக் காண்பிக்கும்படி தேர்வுசெய்யலாம். இது குவிந்த தோற்றம் (cumulative view) என அழைக்கப்படுகிறது, மேலும் மாதாந்திர இலக்கை நோக்கி விற்பனை எப்படி வளர்கிறது என்பது போன்ற ஒரு தேதியளவின் ஒட்டுமொத்த முன்னேற்றத்தைத் தடமறிவதை இது எளிதாக்குகிறது.

இந்தக் குவிந்த தோற்றத்தை ShopifyQL இல் பிரதிபலிக்க, CUMULATIVE_VALUES என்பதை உங்கள் WITH கிளாஸில் சேர்க்கவும். மேலும், உங்கள் ShopifyQL வினவல் இதில் நேரப் பரிமாணத்தைக் கொண்டிருக்க வேண்டும் TIMESERIES அல்லது GROUP BY கூற்றுகள்.

உதாரணமாக:

FROM sales
  SHOW total_sales
  GROUP BY product_title, billing_country
  TIMESERIES day WITH TOTALS, CUMULATIVE_VALUES

ஒவ்வொரு நடப்பு மொத்தத்திற்கும் உருவாக்கப்பட்ட பெயர் இருக்கும், {metric_name}__cumulative, எடுத்துக்காட்டாக net_sales__cumulative, இதை நீங்கள் இதில் குறிப்பிடலாம் ORDER BY மற்றும் VISUALIZE. காலப்போக்கில் மதிப்புகளைக் கூட்டினால் அர்த்தமிருக்காது என்ற நிலையில் உள்ள அளவீடுகள், அதாவது average_order_value அல்லது conversion_rateபோன்றவை, எவ்வித நடப்பு மொத்தத்தையும் உருவாக்காது.

காட்சிப்படுத்தல்களில் குவிந்த மதிப்புகளைச் சேர்ப்பது பற்றி மேலும் அறிக.

SINCE மற்றும் UNTIL

ஒரு தேதி அல்லது குறிப்பிட்ட காலகட்டத்தின்படி உங்கள் வினவலை வடிகட்ட, SINCE மற்றும் UNTIL முக்கியச் சொற்களையும் அவற்றோடு தொடர்புடைய அளவுருக்களையும் பயன்படுத்தவும். இந்த முக்கியச் சொற்கள் தனித்துவமானவை, ஏனெனில் இவை காலகட்டங்களை மட்டுமே வடிகட்டும். இரண்டு எல்லைகளும் உள்ளடக்கப்பட்டுள்ளன.

உதாரணமாக, கனடாவில் கடந்த 12 மாதங்களாக நடந்து நேற்றுடன் முடிவடைந்த நிகர விற்பனையைக் கண்டறிவதற்கான வினவல் இது:

FROM sales
  SHOW net_sales
  WHERE billing_country = 'Canada'
  GROUP BY month
  SINCE -12m UNTIL yesterday

நீங்கள் SINCE என்பதைப் பயன்படுத்தி UNTIL மதிப்பீட்டை வரையறுக்கவில்லை என்றால், உங்கள் நேர வரம்பு நடப்பு நாளின் இறுதி வரை இயங்கும், இது தரும் முடிவும் இதன் முடிவும் ஒன்றுதான்: UNTIL today. அதற்குப் பதிலாக வினவல் இயங்கும் தருணத்தில் வரம்பை முடிக்க, UNTIL nowஎன்பதைப் பயன்படுத்தவும். நீங்கள் UNTIL ஆனது, இந்த அளபுரு இல்லாமல் இடம்பெற்றிருந்தால்: SINCEஎன்பதைப் பயன்படுத்தினால், உங்கள் வினவலில் இதுவும் இருக்க வேண்டும் TIMESERIES, இது இயல்புநிலைத் தொடக்கத் தேதியை வழங்கும். இல்லையெனில், வினவலானது UNTIL requires SINCE without TIMESERIES present என்ற பிழையை வழங்கும்.

ஆஃப்செட் ஆபரேட்டர்கள்

நீங்கள் குறிப்பிட்ட தேதிகள், அல்லது தேதி மற்றும் நேர ஆஃப்செட்களின்படி வடிகட்டலாம். ShopifyQL ஆஃப்செட் ஆபரேட்டர்கள் பின்வருமாறு:

வினாடிகள், நிமிடங்கள் அல்லது குறிப்பிட்ட தேதியின்படி ஆஃப்செட் செய்தல் போன்ற ShopifyQL ஆஃப்செட் ஆபரேட்டர்களின் பட்டியல்.
ஆஃப்செட் ஆபரேட்டர்விளக்கம்
-{#}sவினவல் இயக்கப்பட்ட தேதி மற்றும் நேரத்திற்கு எத்தனை வினாடிகள் முன்பு என்பதைச் சுட்டும்.
-{#}minவினவல் இயக்கப்பட்ட தேதி மற்றும் நேரத்திற்கு எத்தனை நிமிடங்கள் முன்பு என்பதைச் சுட்டும்.
-{#}hவினவல் இயக்கப்பட்ட தேதி மற்றும் நேரத்திற்கு எத்தனை மணிநேரம் முன்பு என்பதைச் சுட்டும்.
-{#}dவினவல் இயக்கப்பட்ட தேதி மற்றும் நேரத்திற்கு எத்தனை நாட்கள் முன்பு என்பதைச் சுட்டும்.
-{#}wவினவல் இயக்கப்பட்ட தேதி மற்றும் நேரத்திற்கு எத்தனை வாரங்கள் முன்பு என்பதைச் சுட்டும்.
-{#}mவினவல் இயக்கப்பட்ட தேதி மற்றும் நேரத்திற்கு எத்தனை மாதங்கள் முன்பு என்பதைச் சுட்டும்.
-{#}qவினவல் இயக்கப்பட்ட தேதி மற்றும் நேரத்திற்கு எத்தனை காலாண்டுகள் முன்பு என்பதைச் சுட்டும்.
-{#}yவினவல் இயக்கப்பட்ட தேதி மற்றும் நேரத்திற்கு எத்தனை ஆண்டுகள் முன்பு என்பதைச் சுட்டும்.
yyyy-MM-ddஒரு குறிப்பிட்ட தேதி.
yyyy-MM-ddThh:mm:ssஒரு குறிப்பிட்ட தேதி மற்றும் நேரம்.

மைனஸ் குறியானது கடந்த காலத்தில் உள்ள ஒரு நேரத்தைக் குறிக்கிறது. நாள்காட்டி எல்லையிலிருந்து அளவிடப்படாமல், வினவல் இயக்கப்படும் நேரத்திலிருந்தான ஒரு குறிப்பிட்ட நேரத்திற்கு ஆஃப்செட் (offset) தீர்வு காணும். எடுத்துக்காட்டாக, நீங்கள் SINCE -1m என்பதை மார்ச் 15 ஆம் தேதி இயக்கினால், உங்கள் வரம்பு பிப்ரவரி 1 ஆம் தேதிக்குப் பதிலாக பிப்ரவரி 15 ஆம் தேதியில் தொடங்கும். மைனஸ் குறியின்றி எழுதப்பட்ட ஆஃப்செட் எதிர்காலத்தில் உள்ள ஒரு நேரத்திற்குத் தீர்வு காணும், எனவே -1m மற்றும் 1m என்பவை ஒன்றுக்கொன்று சமமானவை அல்ல.

நாள்காட்டி எல்லையில் தொடங்கும் அல்லது முடிவடையும் ஒரு வரம்பிற்கு, தேதிச் செயல்பாட்டைப் பயன்படுத்தவும், எடுத்துக்காட்டாக முந்தைய நாள்காட்டி மாதத்திற்கு SINCE startOfMonth(-1m) UNTIL endOfMonth(-1m) அல்லது நடப்பு மாதத்தின் முதல் நாளுக்கு SINCE startOfMonth(0m) என்பதைப் பயன்படுத்தலாம்.

ஆஃப்செட் தீர்வு காணும் நாளின் நேரமானது அதன் அலகைப் பொறுத்து மாறுபடும். விநாடி, நிமிடம் மற்றும் மணிநேர ஆஃப்செட்கள் வினவல் இயங்கும் போதுள்ள நாளின் நேரத்தை அப்படியே வைத்திருக்கும். நாள், வாரம், மாதம், காலாண்டு மற்றும் ஆண்டு ஆஃப்செட்கள் நள்ளிரவிற்குத் தீர்வு காணும், எனவே UNTIL -0m என்பது நடப்பு நேரத்திற்குப் பதிலாக, நடப்பு நாளின் தொடக்கத்தில் உங்கள் வரம்பை முடிக்கும். வினவல் இயங்கும் நேரத்தில் உங்கள் வரம்பை முடிக்க, UNTIL nowஎன்பதைப் பயன்படுத்தவும். நடப்பு நாள் முழுவதையும் சேர்க்க, UNTIL.

தேதிச் செயல்பாடுகள்

பின்வரும் செயல்பாடுகளை எந்தவொரு தேதி வரம்பு ஆபரேட்டர்களுடனும் (குறிப்பிட்ட தேதிகள் நீங்கலாக) SINCE மற்றும் UNTIL அறிக்கைகளில் சேர்த்துப் பயன்படுத்தலாம். "startOf..." செயல்பாடுகளானது, தொடர்புடைய நேர அலகின் (நிமிடம், மணிநேரம், நாள், வாரம், மாதம், காலாண்டு மற்றும் ஆண்டு) தொடக்கத்திற்குச் சுருக்கப்படும். இவை இதனுடன் பயன்படுத்தப்படும்: SINCE, மேலும் "endOf..." செயல்பாடுகளானது, தொடர்புடைய நேர அலகின் முடிவிற்குச் சுருக்கப்படும். இவை இதனுடன் பயன்படுத்தப்படும்: UNTIL.

சரியான முடிவைப் பெற, தேதிச் செயல்பாட்டு அலகுகளும் ஆபரேட்டர் அலகுகளும் பொருந்த வேண்டும். எடுத்துக்காட்டாக, startOfMonth(-1m) என்பது சரி, ஆனால் startOfMonth(-1d) என்பது செல்லுபடியாகாது.

நாளின் முடிவு அல்லது காலாண்டின் தொடக்கம் போன்ற ShopifyQL தேதிச் செயல்பாடுகளின் பட்டியல்.
தேதிச் செயல்பாடுவிளக்கம்
nowவினவல் இயங்கும் தேதி மற்றும் நேரம்.
startOfMinute(-{#}min)தேதி வரம்பு ஆபரேட்டரை இலக்கு நிமிடத்தின் தொடக்கத்திற்குச் சுருக்குகிறது.
endOfMinute(-{#}min)தேதி வரம்பு ஆபரேட்டரை இலக்கு நிமிடத்தின் முடிவிற்குச் சுருக்குகிறது.
startOfHour(-{#}h)தேதி வரம்பு ஆபரேட்டரை இலக்கு மணிநேரத்தின் தொடக்கத்திற்குச் சுருக்குகிறது.
endOfHour(-{#}h)தேதி வரம்பு ஆபரேட்டரை இலக்கு மணிநேரத்தின் முடிவிற்குச் சுருக்குகிறது.
startOfDay(-{#}d)தேதி வரம்பு ஆபரேட்டரை இலக்கு நாளின் தொடக்கத்திற்குச் சுருக்குகிறது.
endOfDay(-{#}d)தேதி வரம்பு ஆபரேட்டரை இலக்கு நாளின் முடிவிற்குச் சுருக்குகிறது.
startOfWeek(-{#}w)தேதி வரம்பு ஆபரேட்டரை இலக்கு வாரத்தின் தொடக்கத்திற்குச் சுருக்குகிறது.
endOfWeek(-{#}w)தேதி வரம்பு ஆபரேட்டரை இலக்கு வாரத்தின் முடிவிற்குச் சுருக்குகிறது.
startOfMonth(-{#}m)தேதி வரம்பு ஆபரேட்டரை இலக்கு மாதத்தின் தொடக்கத்திற்குச் சுருக்குகிறது.
endOfMonth(-{#}m)தேதி வரம்பு ஆபரேட்டரை இலக்கு மாதத்தின் முடிவிற்குச் சுருக்குகிறது.
startOfQuarter(-{#}q)தேதி வரம்பு ஆபரேட்டரை இலக்கு காலாண்டின் தொடக்கத்திற்குச் சுருக்குகிறது.
endOfQuarter(-{#}q)தேதி வரம்பு ஆபரேட்டரை இலக்கு காலாண்டின் முடிவிற்குச் சுருக்குகிறது.
startOfYear(-{#}y)தேதி வரம்பு ஆபரேட்டரை இலக்கு ஆண்டின் தொடக்கத்திற்குச் சுருக்குகிறது.
endOfYear(-{#}y)தேதி வரம்பு ஆபரேட்டரை இலக்கு ஆண்டின் முடிவிற்குச் சுருக்குகிறது.

எடுத்துக்காட்டாக, இன்று நவம்பர் 8, 2022 எனில், ஜனவரி 1, 2020 முதல் அக்டோபர் 31, 2022 வரையிலான மொத்த விற்பனையைப் பெற பின்வரும் வினவலைப் பயன்படுத்தலாம்:

FROM sales
  SHOW gross_sales
  SINCE startOfYear(-2y) UNTIL endOfMonth(-1m)

DURING

இந்த DURING முக்கியச் சொல்லானது தேதி வரம்புகளுக்கான தேதி வடிப்பதை எளிதாக்குகிறது, மேலும் SINCE மற்றும் UNTILஆகியவற்றின் பயன்பாட்டை மாற்றியமைக்கிறது. DURING முழு அறிக்கையிடல் காலக்கட்டத்தையும் வரையறுப்பதால், அதை SINCE அல்லது UNTIL ஆகியவற்றுடன் ஒரே வினவலில் இணைக்க வேண்டாம்.

நீங்கள் DURING முக்கியச் சொல்லைப் பயன்படுத்தி, நாள்காட்டி ஆண்டு அல்லது குறிப்பிட்ட மாதம் போன்ற தெரிந்த காலக்கட்டத்திற்கோ, அல்லது பிளாக் ஃப்ரைடே சைபர் மண்டே (BFCM) போன்ற ஒவ்வொரு ஆண்டும் தேதிகள் மாறுபடும் வரம்புகளுக்கோ வினவல் முடிவுகளை வடிகட்டலாம். DURING என்பது, பின்வருவது போன்ற பெயரிடப்பட்ட தேதி வரம்பு ஆபரேட்டர்களைக் மட்டுமே ஏற்கும்: yesterday அல்லது last_year, மேலும் இது இவற்றை ஏற்காது: now.

எடுத்துக்காட்டாக, இந்த வினவல் 2021 ஆம் ஆண்டின் BFCM தேதியின்படி வடிகட்டுகிறது:

FROM sales
  SHOW total_sales
  GROUP BY day
  DURING bfcm2021

எல்லையாக ஒரு குறிப்பிட்ட தேதி, தொடர்புடைய ஆஃப்செட் அல்லது தேதிச் செயல்பாடு தேவைப்பட்டால், நீங்கள் பயன்படுத்த வேண்டியது SINCE மற்றும் UNTIL.

பெயரிடப்பட்ட தேதி வரம்பு ஆபரேட்டர்கள்

DURING பின்வரும் ஏதேனும் பெயரிடப்பட்ட தேதி வரம்பு ஆபரேட்டர்களை ஏற்கும்:

இன்று, நேற்று அல்லது இந்த வாரம் போன்ற ShopifyQL பெயரிடப்பட்ட தேதி வரம்பு ஆபரேட்டர்களின் பட்டியல்.
பெயரிடப்பட்ட தேதி வரம்பு ஆபரேட்டர்விளக்கம்
todayவினவல் இயங்கும் தேதி.
yesterdayமுந்தைய நாள்காட்டி நாள்.
this_weekநடப்பு நாள்காட்டி வாரம்.
this_monthநடப்பு நாள்காட்டி மாதம்.
this_quarterநடப்பு நாள்காட்டி காலாண்டு.
this_yearநடப்பு நாள்காட்டி ஆண்டு.
last_weekமுந்தைய நாள்காட்டி வாரம்.
last_monthமுந்தைய நாள்காட்டி மாதம்.
last_quarterமுந்தைய நாள்காட்டி காலாண்டு.
last_yearமுந்தைய நாள்காட்டி ஆண்டு.
this_weekendநடப்பு வார இறுதி.
last_weekendமுந்தைய வார இறுதி.
bfcmYYYYகுறிப்பிடப்பட்ட ஆண்டிற்கான பிளாக் ஃப்ரைடே சைபர் மண்டே வரம்பு. எடுத்துக்காட்டாக, bfcm2022 என்பது 25-28 நவம்பர், 2022-க்கான முடிவுகளை வழங்கும்.

COMPARE TO

இந்த COMPARE TO முக்கியச் சொல், நீங்கள் SINCE மற்றும் UNTILஅல்லது DURINGஆகியவற்றின் மூலம் அமைக்கும் அறிக்கையிடல் காலக்கட்டத்தை மற்றொரு காலக்கட்டத்துடனோ அல்லது உள்ளமைக்கப்பட்ட இலக்குகளுடனோ ஒப்பிடுகிறது.

நீங்கள் COMPARE TO முக்கியச் சொல்லுடன் பின்வரும் வகை அளவுருக்களைப் பயன்படுத்தலாம்:

  • 2023-01-01 போன்ற தனித்த தேதிகள்: குறிப்பிட்ட காலக்கட்டத்திற்கான அளவீடுகளையும், தனித்த தேதியில் அதே காலக்கட்டத்திற்கான ஒப்பீட்டு அளவீடுகளையும் உள்ளடக்கும்.
  • பெயரிடப்பட்ட தேதிகள், எடுத்துக்காட்டாக last_week: குறிப்பிட்ட காலக்கட்டத்திற்கான அளவீடுகளையும், பெயரிடப்பட்ட தேதியில் அதே காலக்கட்டத்திற்கான ஒப்பீட்டு அளவீடுகளையும் உள்ளடக்கும்.
    • பயன்படுத்தும் ஆபரேட்டரானது, COMPARE TO பயன்படுத்தும் ஆபரேட்டரின் அதே கால நீளத்தைக் கொண்டிருக்க வேண்டியதில்லை. DURING. எந்தவொரு UNTIL மதிப்பு வழங்கப்பட்டால், இதில் குறிப்பிடப்பட்டுள்ள மதிப்பிற்கு ஈடாக நேர வரம்பை அது கணக்கிடும் DURING. உதாரணமாக, DURING this_week COMPARE TO last_month என்பது இந்த வாரத்தின் தரவை, கடந்த மாதத்தின் தொடக்கத்தில் தொடங்கும் ஒரு வாரக் காலத்துடன் ஒப்பிடுகிறது.
  • -3q போன்ற ஆஃப்செட் தேதிகள்: குறிப்பிட்ட காலத்திற்கான அளவீடுகள் மற்றும் தொடர்புடைய தேதியில் உள்ள அதே காலத்திற்கான ஒப்பீட்டு அளவீடுகள் ஆகியவற்றை உள்ளடக்கியிருக்கும்.
  • -1y, -2y போன்ற பல தேதி ஒப்பீடுகள்: ஒரு குறிப்பிட்ட தேதி வரம்பிலிருந்து உங்கள் தரவை மற்ற பல தேதி வரம்புகளுடன் ஒப்பிடும். பல காலகட்டங்களில் ஏற்பட்டுள்ள மாற்றங்களைத் தடமறிய நீங்கள் விரும்பும் போது இது பயனுள்ளதாக இருக்கும்.
  • உள்ளமைக்கப்பட்ட இலக்குகள், பயன்படுத்துவது COMPARE TO TARGETS: வேறொரு தேதி வரம்புடன் ஒப்பிடுவதற்குப் பதிலாக, ஒரு அளவீட்டிற்காக நீங்கள் அமைத்த இலக்குகளுடன் உங்கள் தரவை ஒப்பிடலாம். இலக்குகளை ஆதரிக்கும் அளவீடுகளுக்கு இந்த விருப்பம் கிடைக்கும்.
  • ஒரு வினவலில் தேதிப் பரிமாணத்தை நீங்கள் பயன்படுத்தும்போது அதில் COMPARE TOஇருந்தால், அதற்காக TIMESERIES என்பதைப் பயன்படுத்தவும், இதை அல்ல: GROUP BY.

பின்வரும் உதாரணம் முந்தைய நாள்காட்டி மாதத்தின் நிகர விற்பனையை முந்தைய ஆண்டின் அதே மாதத்துடன் ஒப்பிடுகிறது:

FROM sales
  SHOW net_sales, product_title
  GROUP BY product_title
  TIMESERIES day
  SINCE startOfMonth(-1m) UNTIL endOfMonth(-1m)
  COMPARE TO previous_year

நீங்கள் இதைப் பயன்படுத்தும்போது: COMPARE TO, ஒவ்வொரு ஒப்பிடப்பட்ட அளவீடும் ஒரு ஒப்பீட்டு மதிப்பைப் பெறும். தரவு அட்டவணையில் ஒப்பீட்டு மதிப்புகள் அவற்றின் சொந்த நெடுவரிசைகளில் காட்டப்படாது. தரவு அட்டவணையின் ஒவ்வொரு கலமும் அறிக்கையிடல்-கால மதிப்பை ஒப்பீட்டு-கால மதிப்புடன் அடுக்கும், அதேபோல ஒவ்வொரு வரிசை லேபிளும் 2 காலக்கட்டங்களை அடுக்கும். ஒவ்வொரு ஒப்பீடும் தானாக உருவாக்கப்படும் பெயரைக் கொண்டிருக்கும், இது அளவீட்டையும் ஒப்பீட்டுக் காலத்தையும் ஒருங்கிணைக்கும்; எனவே ஒரு அளவீடு ஒன்றுக்கும் மேற்பட்ட ஒப்பீடுகளைக் கொண்டிருக்கலாம். பெயரைக் கொண்டு ஒரு ஒப்பீட்டை நீங்கள் இதில் குறிப்பிடலாம் ORDER BY அல்லது VISUALIZE:

  • தொடர்புடைய ஒப்பீட்டினால் இது சேர்க்கப்படும்: comparison_net_sales__previous_year.
  • ஒரு குறிப்பிட்ட தேதிக்கான ஒப்பீட்டினால் இது சேர்க்கப்படும்: comparison_net_sales__20230101.
  • பெயரிடப்பட்ட தேதி ஒப்பீட்டினால் இது சேர்க்கப்படும்: comparison_net_sales__last_week.
  • தேதிச் செயல்பாடு ஒப்பீட்டினால் இது சேர்க்கப்படும்: comparison_net_sales__startOfQuarter_sub_3q, இதில் ஒவ்வொரு கழித்தல் குறியும் இப்படி மாறும் sub.

தொடர்புடைய தேதி வரம்பு ஆபரேட்டர்கள்

தொடர்புடைய ஆபரேட்டர்கள், அடிப்படைத் தேதி வரம்பிற்கு இணையான கால அளவை, குறிப்பிட்ட கால அளவுக்குப் பின்னோக்கி மாற்றி வழங்கும். பெயரிடப்பட்ட தேதி வரம்பு ஆபரேட்டர்கள் தவிர, COMPARE TO ஆனது பின்வரும் தொடர்புடைய ஆபரேட்டர்களை ஏற்கும்:

முந்தைய காலம் அல்லது முந்தைய ஆண்டு போன்ற ShopifyQL தொடர்புடைய தேதி வரம்பு ஆபரேட்டர்களின் பட்டியல்.
தொடர்புடைய தேதி வரம்பு ஆபரேட்டர்விளக்கம்
previous_periodஅடிப்படைத் தேதி வரம்பிற்கு முன் ஒரு காலம்.
previous_yearஅடிப்படைத் தேதி வரம்பிற்கு முன் ஒரு ஆண்டு.
previous_quarterஅடிப்படைத் தேதி வரம்பிற்கு முன் ஒரு காலாண்டு.
previous_monthஅடிப்படைத் தேதி வரம்பிற்கு முன் ஒரு மாதம்.
previous_weekஅடிப்படைத் தேதி வரம்பிற்கு முன் ஒரு வாரம்.
previous_dayஅடிப்படைத் தேதி வரம்பிற்கு முன் ஒரு நாள்.
previous_hourஅடிப்படைத் தேதி வரம்பிற்கு முன் ஒரு மணிநேரம்.
previous_minuteஅடிப்படைத் தேதி வரம்பிற்கு முன் ஒரு நிமிடம்.
previous_secondஅடிப்படைத் தேதி வரம்பிற்கு முன் ஒரு விநாடி.
previous_year_match_day_of_weekஅடிப்படைத் தேதி வரம்பிற்கு 52 வாரங்களுக்கு முன்பு, இது வாரத்தின் அதே நாள்களுடன் ஒப்பீட்டைச் சீரமைத்திருக்கும்.

இலக்குகளுடன் ஒப்பிடுதல்

COMPARE TO TARGETS என்பதற்கு இது தேவை: TIMESERIES மேலும் ஒரு அறிக்கையிடல் காலம்; அதை நீங்கள் இதனைக் கொண்டு அமைக்கலாம் SINCE, UNTIL, அல்லது DURING. உங்களால் இதை இணைக்க முடியாது TARGETS வேறு எந்த ஒப்பீட்டு காலத்துடனும். தேதி ஒப்பீட்டைப் போலன்றி, இலக்குகள் உங்கள் வினவல் முடிவுகளில் எந்த மதிப்புகளையும் சேர்க்காது, எனவே உங்கள் தரவு அட்டவணை மாற்றமடையாது, மேலும் PERCENT_CHANGE எவ்விதத் தாக்கத்தையும் ஏற்படுத்தாது. மாறாக, உங்கள் இலக்கு ஒரு கோடு அல்லது பட்டை காட்சிப்படுத்தலின் ஒட்டுமொத்தக் காட்சியில் பேஸிங் லைனாக (Pacing line) காட்சிப்படுத்தப்படும்.

ஒரு இலக்கை நோக்கிய உங்கள் முன்னேற்றத்தைக் காட்டி (Gauge) மூலம் காட்ட, இதைப் பயன்படுத்தவும் VISUALIZE {metric} TYPE target_gauge. ஒரு இலக்குக் காட்டிக்கு (Target gauge) இது தேவையில்லை COMPARE TO TARGETS, ஆனால் உங்கள் வினவலின் தேதி வரம்பு நீங்கள் அமைத்துள்ள இலக்கின் கால அளவோடு பொருந்த வேண்டும். தேதி வரம்புடன் எந்த இலக்கும் பொருந்தவில்லை என்றால், உங்கள் தேர்விற்கான இலக்கு எதுவும் கண்டறியப்படவில்லை என்று காட்சிப்படுத்தல் தெரிவிக்கும்.

அளவீடுகளுக்கான இலக்குகளை அமைப்பது பற்றி மேலும் அறிக.

ORDER BY

உங்கள் வினவல் மூலம் பெறப்படும் தரவை எவ்வாறு வரிசைப்படுத்த வேண்டும் என்பதை இந்த முக்கியச் சொல்லைக் கொண்டு நீங்கள் குறிப்பிடலாம் ORDER BY , மற்றும் அதன் அளவுருக்கள்: ASC, ஏறு வரிசைக்கு, மற்றும் DESC, இறங்கு வரிசைக்கு.

உங்கள் வினவலில் நீங்கள் சேர்த்துள்ள ஏதேனும் ஒரு அளவீடு அல்லது பரிமாணத்தை இதில் நீங்கள் குறிப்பிடலாம் ORDER BY முக்கியச் சொல்; பல புலங்களைச் சேர்ப்பது உட்பட.

உதாரணமாக, இந்த வினவல் கடந்த ஆண்டில் அனைத்து தயாரிப்புகள் மற்றும் மாறுபாடுகளுக்கான நிகர விற்பனையை வழங்குகிறது. முடிவுகள் முதலில் தயாரிப்புத் தலைப்பின் மூலம் அகர வரிசைப்படியும், பின்னர் தயாரிப்பு வகை மூலம் தலைகீழ் அகர வரிசைப்படியும் வரிசைப்படுத்தப்படும்:

FROM sales
  SHOW net_sales
  GROUP BY product_title, product_type
  SINCE -1y UNTIL today
  ORDER BY product_title, product_type DESC

உங்கள் அளவீடுகள் அல்லது பரிமாணத்தை நீங்கள் எழுதும் வரிசை மிகவும் முக்கியம். நீங்கள் பல மதிப்புகளைக் குறிப்பிட்டால் ORDER BY, கொடுக்கப்பட்டுள்ள வரிசையில் உள்ள ஒவ்வொரு அளவீடு அல்லது பரிமாணத்திற்கும் வரிசைப்படுத்தல் பயன்படுத்தப்படும்.

TIMESERIES மற்றும் முடிவுகளின் வரிசை

வினவலில் இது சேர்க்கப்பட்டுள்ளதா இல்லையா என்பதைப் பொறுத்து, TIMESERIES மற்றும் ORDER BYபெறப்படும் வரிசைகளின் ஒழுங்கு மாறலாம்.

ShopifyQL-ஐப் பயன்படுத்தி ORDER BY இருக்கும்போது, TIMESERIES மற்றும் பெறப்படும் வரிசைகளின் ஒழுங்குமுறைக்கான உதாரணம்.
TIMESERIESORDER BYமுடிவு
உள்ளதுஇல்லைமுடிவுகள் இதன்மூலம் வரிசைப்படுத்தப்பட்டுள்ளன TIMESERIES பரிமாணம்.
உள்ளதுஉள்ளதுமுடிவுகள் இதன்மூலம் வரிசைப்படுத்தப்பட்டுள்ளன TIMESERIES நேரப் பரிமாணம், அதன் பின்னர் ORDER BY பரிமாணம்.
இல்லைஉள்ளதுமுடிவுகள் இதன்மூலம் வரிசைப்படுத்தப்பட்டுள்ளன ORDER BY பரிமாணம்.
இல்லைஇல்லைமுதல் இதன் அடிப்படையில் முடிவுகள் வரிசைப்படுத்தப்பட்டுள்ளன SHOW நெடுவரிசை.

LIMIT

இந்த LIMIT முக்கியச் சொல் வினவலின் மூலம் பெறும் அதிகபட்ச வரிசைகளின் எண்ணிக்கையைக் குறிப்பிட உங்களை அனுமதிக்கிறது. தரவு எவ்வாறு காட்டப்படுகிறது என்பதை முன்னோட்டமிட, பெரிய தரவுத்தொகுப்புகளில் வினவல்களை விரைவுபடுத்த அல்லது முதல் 10 பட்டியல்களை உருவாக்க விரும்பும்போது இது பயனுள்ளதாக இருக்கும். இதை நீங்கள் இணைக்கலாம் LIMIT என்பதை இதனுடன் சேர்த்துப் பயன்படுத்தவும்: ORDER BY மேல் மற்றும் கீழ் பட்டியல்களை உருவாக்குவதற்கு.

நீங்கள் ஒரு LIMIT மதிப்பைக் குறிப்பிடவில்லை எனில், வினவல் இயல்புநிலையாக 1000 வரிசைகளை வழங்கும்.

நீங்கள் இதையும் விருப்பத்திற்குரியதாகப் பயன்படுத்தலாம்: { OFFSET # } வரிசைத் தரவை வழங்கத் தொடங்குவதற்கு முன் குறிப்பிட்ட எண்ணிக்கையிலான வரிசைகளைத் தவிர்ப்பதற்கான அளவுரு. இதன் விளைவாக வரும் சொற்றொடர் பின்வருவதைப் போன்று வடிவமைக்கப்படும்: LIMIT 15 { OFFSET 5 }.

இந்த உதாரணம் பயன்படுத்துவது LIMIT மற்றும் ORDER BY கடந்த 3 மாதங்களில் அதிகம் விற்பனையான முதல் 10 தயாரிப்புகளின் பட்டியலை உருவாக்குவதற்கு:

FROM sales
  SHOW gross_sales as total_gross_sales
  GROUP BY product_title
  SINCE -3m UNTIL today
  ORDER BY total_gross_sales DESC
  LIMIT 10

VISUALIZE மற்றும் TYPE

இந்த VISUALIZE முக்கியச் சொல், தரவை ஒரு வரைவியல் காட்சிப்படுத்தலில் காண்பிக்கும் ShopifyQL வினவலை எழுத உங்களை அனுமதிக்கிறது.

இந்த TYPE முக்கியச் சொல் கட்டாயமற்றது, இதனுடன் ஒரு வகை காட்சிப்படுத்தல் மட்டுமே இடம்பெற வேண்டும். TYPE உங்கள் வினவலில் சேர்க்கப்படவில்லை எனில், உங்கள் வினவலுக்கு மிகவும் பொருத்தமான காட்சிப்படுத்தலை ShopifyQL தானாகவே தேர்ந்தெடுக்கும். உள்ளபடியே உங்கள் வினவலைக் காட்சிப்படுத்த முடியவில்லை எனில், அட்டவணைத் தரவை ShopifyQL வழங்கும். இதற்கு, நீங்கள் TYPE முக்கியச் சொல்லை உங்கள் Shopify அறிக்கைக்கான சரியான காட்சிப்படுத்தலைத் தேர்ந்தெடுத்தல் என்பதில் ஒவ்வொரு காட்சிப்படுத்தலுக்கும் பார்க்கலாம்.

VISUALIZE கட்டாயமற்ற LIMIT முக்கியச் சொல்லையும் ஏற்கிறது, இதில் காட்சிப்படுத்தல் மற்றும் தரவு அட்டவணையில் ரெண்டர் செய்ய வேண்டிய குறைந்த அளவிலான தரவுப் புள்ளிகளே அளபுருவாக இருக்கும். நீங்கள் கட்டாயமற்ற MAX முக்கியச் சொல்லைப் பயன்படுத்தி, தரவு அட்டவணையில் உள்ள தரவைப் பாதிக்காமல் காட்சிப்படுத்தலில் உள்ள தரவுப் புள்ளிகளின் எண்ணிக்கையைக் கட்டுப்படுத்தவும் முடியும். MAX என்பதே புதிய வினவல்களில் விரும்பப்படும் முக்கியச் சொல்லாகும்.

எடுத்துக்காட்டாக, கடந்த ஆண்டிற்கான உங்கள் விற்பனைப் போக்கை மாத வாரியாக ஒரு டிரெண்ட் லைன் மூலம் காட்சிப்படுத்தலாம். இந்த வினவல் கடந்த ஆண்டில் மாத வாரியான மொத்த விற்பனையைக் காட்டும் நேரத் தொடர் விளக்கப்படத்தை வழங்கும். மொத்த விற்பனை ஒற்றைக் கோடு மூலம் சித்தரிக்கப்படுகிறது, இதில் x அச்சு மாதம் எனவும் y அச்சு மொத்த விற்பனை எனவும் லேபிளிடப்பட்டிருக்கும்:

FROM sales
  SHOW gross_sales
  TIMESERIES month
  SINCE -1y UNTIL today
VISUALIZE gross_sales TYPE line

காட்சிப்படுத்தல்களில் பல அளவீடுகள்

உங்கள் அறிக்கைக்கான கோடு வகை காட்சிப்படுத்தல்களில் நீங்கள் பல அளவீடுகளைச் சேர்க்கலாம். காட்சிப்படுத்தலில் சேர்க்கப்பட்டுள்ள ஒவ்வொரு அளவீடும் காற்புள்ளியால் பிரிக்கப்பட்டு, TYPE line முக்கியச் சொல்லுடன் இருக்க வேண்டும். SHOW என்பதில் பட்டியலிடப்பட்டிருந்தும், VISUALIZE என்பதில் இல்லாத அளவீடுகள் தரவு அட்டவணையில் மட்டுமே காண்பிக்கப்படும்.

எடுத்துக்காட்டாக, பின்வரும் வினவல் காட்சிப்படுத்தலில் மொத்த விற்பனை, ஆர்டர்கள் மற்றும் அமர்வுகளை 3 தனித்தனி கோடுகளாகச் சேர்க்கிறது. தரவு அட்டவணையில் மொத்த விற்பனை காண்பிக்கப்படும், ஆனால் காட்சிப்படுத்தலில் அல்ல:

FROM sales
  SHOW total_sales, orders, sessions, gross_sales
  TIMESERIES month
  SINCE -1y UNTIL today
VISUALIZE total_sales, orders, sessions TYPE line

Bar and line வகை காட்சிப்படுத்தலைப் பயன்படுத்த, நீங்கள் 2 அளவீடுகளையும் காற்புள்ளியால் பிரித்து வெவ்வேறு TYPE மதிப்பை ஒவ்வொரு அளவீட்டுக்கும் குறிப்பிடலாம்:

FROM sales
  SHOW total_sales, orders, conversion_rate, gross_sales
  TIMESERIES month
  SINCE -1y UNTIL today
VISUALIZE total_sales TYPE bar, conversion_rate TYPE line

அறிக்கை காட்சிப்படுத்தல்களில் பல அளவீடுகளைச் சேர்ப்பது குறித்து மேலும் அறிக.

ANNOTATE

இந்த ANNOTATE முக்கியச் சொல் உங்கள் காட்சிப்படுத்தலில் சிறுகுறிப்புகளைக் காண்பிக்கும், எனவே அளவீட்டில் ஏற்படும் மாற்றத்தை, அதற்கான நிகழ்வுகளுடன் ஒப்பிட முடியும்.

இதை எழுதவும்: ANNOTATE (உங்கள் VISUALIZE ஸ்டேட்மெண்ட்டின் முடிவில், ஏதேனும் TYPE மற்றும் MAX அளபுருக்களுக்குப் பிறகு). நீங்கள் பின்வரும் வழிகளில் சிறுகுறிப்புகளைச் சேர்க்கலாம்:

  • ANNOTATE ALL: Shopify மூலம் உருவாக்கப்படும் சிறுகுறிப்புகள், செயலிகளால் உருவாக்கப்பட்டவை மற்றும் நீங்களும் உங்கள் பணியாளர்களும் உருவாக்கிய சிறுகுறிப்புகள் உட்பட, அனைத்து ஆதாரங்களிலிருந்தும் ஒவ்வொரு சிறுகுறிப்பு வகையையும் காண்பிக்கும்.
  • ANNOTATE {category}: ஒரு பிரிவிலுள்ள ஒவ்வொரு சிறுகுறிப்பையும் காண்பிக்கும், எடுத்துக்காட்டாக ANNOTATE product_events.
  • ANNOTATE {category}.{type}: ஒரு வகையான சிறுகுறிப்பைக் காண்பிக்கும், எடுத்துக்காட்டாக ANNOTATE product_events.published.

பிரிவுகள் மற்றும் வகைகளை ஒன்றிணைக்க, அவற்றைக் காற்புள்ளிகளால் பிரிக்கவும். சிறுகுறிப்புப் பிரிவுகள் மற்றும் வகைகளின் முழுமையான பட்டியலுக்கு Shopify டெவலப்பர் ஆவணங்களைப் பார்க்கவும்.

எடுத்துக்காட்டாக, இந்த வினவல் கடந்த 90 நாட்களுக்கான தினசரி மொத்த விற்பனையைக் காண்பிக்கிறது, மேலும் வெளியிடப்பட்ட அல்லது வெளியிடப்படாத ஒவ்வொரு தயாரிப்புக்கும் மற்றும் வெளியிடப்பட்ட ஒவ்வொரு தீமுக்கும் குறிப்பான்களையும் காட்டுகிறது:

FROM sales
  SHOW total_sales
  TIMESERIES day
  SINCE -90d
VISUALIZE total_sales TYPE line ANNOTATE product_events, online_store_events.theme_published

குறிப்பிட்ட ஆதாரங்கள் அல்லது உருவாக்கியவர்களிடமிருந்து மட்டுமே சிறுகுறிப்புகளைக் காண்பிக்க, இதைச் சேர்க்கவும் FILTER என்பதைச் சிறுகுறிப்பு வகைகள் மற்றும் ரகங்களுக்குப் பிறகு சேர்த்து, தொடர்ந்து ஒன்று அல்லது அதற்கு மேற்பட்ட நிபந்தனைகளைச் சேர்க்கவும். நீங்கள் இதைச் சேர்க்கவில்லை என்றால் FILTER, எல்லா ஆதாரங்களிலிருந்தும் சிறுகுறிப்புகள் காண்பிக்கப்படும். பின்வரும் புலங்கள் மூலம் சிறுகுறிப்புகளை நீங்கள் வடிகட்டலாம்:

  • source: சிறுகுறிப்பின் ஆதாரம். இதைப் பயன்படுத்தவும் 'shopify' என்பதை Shopify மூலம் உருவாக்கப்படும் சிறுகுறிப்புகளுக்கும், 'app' என்பதைச் செயலிகளால் உருவாக்கப்பட்ட சிறுகுறிப்புகளுக்கும், அல்லது 'staff' என்பதை நீங்களும் உங்கள் பணியாளர்களும் உருவாக்கும் சிறுகுறிப்புகளுக்கும் பயன்படுத்தவும்.
  • app_id: சிறுகுறிப்பை உருவாக்கிய செயலியின் ID.
  • staff_id: சிறுகுறிப்பை உருவாக்கிய பணியாளரின் ID.

நீங்கள் இதைப் பயன்படுத்தலாம்: = என்பதை ஒரு மதிப்பைக் கொண்டு வடிகட்டவும், அல்லது IN என்பதைப் பின்வருவது போன்ற மதிப்புகளின் பட்டியலைக் கொண்டு வடிகட்டவும் பயன்படுத்தவும் source IN ('app', 'staff'). மேற்கோள் குறிகள் இல்லாமல் செயலி மற்றும் பணியாளர்களின் IDகளை எண்களாக உள்ளிடவும், எடுத்துக்காட்டாக staff_id = 123. நிபந்தனைகளை ஒன்றிணைக்க, அவற்றை இதைக் கொண்டு பிரிக்கவும் OR. சிறுகுறிப்பு வடிப்பான்கள் இதை ஆதரிக்காது AND. புலத்தின் பெயர்கள் மற்றும் மூல மதிப்புகள் பெரிய/சிறிய எழுத்து உணர்திறன் கொண்டவை. நீங்கள் app_id அல்லது staff_id என்பதை ShopifyQL வினவல் எடிட்டரில் உள்ளிடும்போது, சிறுகுறிப்புகளை உருவாக்கிய செயலிகள் மற்றும் பணியாளர்கள் பரிந்துரைக்கப்படுவார்கள்.

எடுத்துக்காட்டாக, கடந்த 90 நாட்களுக்கான தினசரி மொத்த விற்பனையை இந்த வினவல் காண்பிக்கிறது, அத்துடன் நீங்களும் உங்கள் பணியாளர்களும் உருவாக்கிய ஒவ்வொரு சிறுகுறிப்புக்குமான குறிப்பான்களையும் காட்டுகிறது:

FROM sales
  SHOW total_sales
  TIMESERIES day
  SINCE -90d
VISUALIZE total_sales TYPE line ANNOTATE ALL FILTER source = 'staff'

சிறுகுறிப்புகளுக்கு நேரப் பரிமாணம் தேவை, எனவே உங்கள் வினவல், TIMESERIES அல்லது GROUP BYஎன்பதன் மூலம் நேரப் பரிமாணம் ஒன்றைக் கொண்டுவர வேண்டும், மேலும் நேர அச்சைக் கொண்ட ஒரு காட்சிப்படுத்தல் வகையைப் பயன்படுத்த வேண்டும். பின்வருவதைப் பயன்படுத்தும் பல ஸ்டோர் வினவல்களுக்குச் சிறுகுறிப்புகள் கிடைக்காது: FROM ORGANIZATION.

AS

முக்கியச் சொல் AS என்பது, ஒரு நெடுவரிசை அல்லது வெளிப்பாட்டிற்கு மறுபெயரிட (அல்லது மாற்றுப்பெயரை வழங்க) அனுமதிக்கும் கட்டாயமற்ற முக்கியச் சொல்லாகும்.

AS ஒரேயொரு அளபுருவை மட்டுமே ஏற்கும். மாற்றுப்பெயரில் இடைவெளி இருந்தால், நீங்கள் மாற்றுப்பெயரை இரட்டை மேற்கோள் குறிகளுக்குள் (") கொடுக்க வேண்டும்.

FROM sales
  SHOW total_sales AS "My Total Sales"

பிற ShopifyQL ஆபரேட்டர்கள் மற்றும் அம்சங்கள்

ShopifyQL இல் பின்வரும் கூடுதல் ஆபரேட்டர்கள் உள்ளன:

கணித ஆபரேட்டர்கள்

உங்கள் தரவில் உள்ள அளவீடுகளுடன் கணிதச் செயல்பாடுகளை மேற்கொள்ள ShopifyQL அனுமதிக்கிறது. பின்வரும் கணித ஆபரேட்டர்கள் உள்ளன:

கூட்டல் மற்றும் கழித்தல் உள்ளிட்ட ShopifyQL கணித ஆபரேட்டர்களின் பட்டியல்.
கணித ஆபரேட்டர்விளக்கம்
+இரண்டு எண்களின் கூட்டல்.
-இரண்டு எண்களின் கழித்தல்.
*இரண்டு எண்களின் பெருக்கல்.
/இரண்டு எண்களின் வகுத்தல்.

கணித வெளிப்பாடுகள் பின்வரும் வரம்புகளைக் கொண்டுள்ளன:

  • ஒரு வெளிப்பாட்டில் உள்ள இரண்டு மதிப்புகளும் எண்களாக இருக்க வேண்டும். ID ஆனது ஒரு எண்ணாகக் காண்பிக்கப்பட்டாலும் கூட, தயாரிப்புத் தலைப்புகள், IDகள் மற்றும் சரி அல்லது தவறு மதிப்புகள் போன்ற பரிமாணங்களைக் கணிதச் செயல்பாடுகளில் பயன்படுத்த முடியாது.
  • தேதிகள் மற்றும் நேரங்கள் கழித்தலை மட்டுமே ஆதரிக்கின்றன. நீங்கள் ஒரு தேதியிலிருந்து மற்றொரு தேதியை அல்லது ஒரு நேரத்திலிருந்து மற்றொரு நேரத்தைக் கழிக்கலாம், ஆனால் அவற்றைக் கூட்டவோ பெருக்கவோ வகுக்கவோ முடியாது.
  • வெளிப்பாடுகள் SHOW முக்கியச் சொல்லில் கணக்கிடப்படுகின்றன. ஒரு WHERE நிபந்தனையில் எவ்விதக் கணிதச் செயல்பாடும் இருக்க முடியாது.
  • அட்டவணைகளை இணைக்கப் பயன்படும் ஒரு புலத்தில் கணிதச் செயல்பாட்டைப் பயன்படுத்த முடியாது. மறைமுக இணைப்புகள் குறித்து மேலும் அறிக.

எடுத்துக்காட்டாக, இந்த வினவல் கடந்த ஆண்டில் ஒவ்வொரு பிராந்தியத்திற்குமான ஆர்டர் மதிப்பைக் கணக்கிடுகிறது. அளவீடுகளுடன் கணித ஆபரேட்டர்களைப் பயன்படுத்தும்போது, நீங்கள் AS முக்கியச் சொல்லைப் பயன்படுத்தி புதிய அளவீட்டுக்குப் புதிய பெயரை ஒதுக்கலாம்.

FROM sales
  SHOW (net_sales + sales_reversals) AS order_value, orders
  GROUP BY billing_region
  SINCE -1y UNTIL today

மறைமுக இணைப்புகள்

வெவ்வேறு டொமைன்களில் உள்ள அளவீடுகளை ஒன்றாக, அருகருகே பார்க்க ஒரு இணைப்பு உங்களை அனுமதிக்கிறது. இணைப்புகள் ShopifyQL இல் மறைமுகமாகவும் அறிவுப்பூர்வமாகவும் செய்யப்படுகின்றன.

ShopifyQL ஆனது பின்வரும் இணைப்புத் திறன்களைக் கொண்டுள்ளது:

  • வினவலில் ஒரேயொரு FROM அட்டவணை இருக்கும்போது, பரிமாணப் புல இணைப்புகளை ShopifyQL அனுமதிக்கிறது.
  • பரிமாணப் புலங்களில் தானியங்கி இடது இணைப்பு (Automatic left join).
  • ShopifyQL பல-தரவு இணைப்புகளை (multi-fact joins) அனுமதிக்கிறது (வினவல்களில் பல FROM அட்டவணைகள் இருக்கும்போது).
  • மல்டி-ஃபாக்ட் ஜாயிண்டுகளில் தானியங்கி முழு ஜாயிண்ட் செயல்படும், இவை எந்த எண்ணிக்கையிலான டேபிள்கள் அல்லது ஸ்கீமாக்களையும் ஆதரிக்கும், அத்துடன் பரிமாணங்களால் குழுவாக்கப்படும்.
  • மல்டி-ஃபாக்ட் ஜாயிண்டுகளில் உள்ள அளவீடுகள் கணிதத்தைப் பயன்படுத்தலாம்.

ShopifyQL பின்வரும் ஜாயிண்ட் கட்டுப்பாடுகளைக் கொண்டுள்ளது:

  • ஜாயிண்ட் செய்யப்பட்ட அனைத்து ஸ்கீமாக்களிலும் ஜாயிண்ட் ஃபீல்டு ஒரே பெயரைக் கொண்டிருக்க வேண்டும்.
  • ஜாயிண்ட் ஃபீல்டானது இதில் இருக்க வேண்டும்: GROUP BY.
  • ஜாயிண்ட் ஃபீல்டு கணிதத்தைப் பயன்படுத்த முடியாது.
  • FROM என்பது மல்டி-ஃபாக்ட் ஜாயிண்டுகள் செயல்பட அவசியமாகும்.
  • மல்டி-ஃபாக்ட் ஜாயிண்டில், ஒவ்வொரு GROUP BY என்பதும் அனைத்து ஸ்கீமாக்களிலும் இருக்க வேண்டும், மேலும் இது ஜாயிண்ட் செய்வதற்கான ஃபீல்டாகக் கருதப்படும்.

எடுத்துக்காட்டாக, இந்தக் குவெரி மல்டி-ஃபாக்ட் ஜாயிண்டைப் பயன்படுத்துகிறது:

FROM sales, sessions
  SHOW day, total_sales, sessions
  GROUP BY day
  SINCE 2023-10-03
  ORDER BY day

பகுதிச் சரம் மற்றும் அரே பொருத்துதல்

பகுதிச் சரம் மற்றும் அரே பொருத்துதலுக்குப் பின்வரும் ஆப்பரேட்டர்களைப் பயன்படுத்தலாம்:

ShopifyQL இல் உள்ள பகுதிச் சரம் மற்றும் அரே பொருத்துதல் ஆப்பரேட்டர்களின் பட்டியல்.
ஆப்பரேட்டர்விளக்கம்
STARTS WITHநெடுவரிசையானது ஒரு முன்னொட்டுடன் தொடங்கும் எல்லா வரிசைகளையும் வழங்கும்.
ENDS WITHநெடுவரிசையானது ஒரு பின்னொட்டுடன் முடிவடையும் எல்லா வரிசைகளையும் வழங்கும்.
CONTAINSநெடுவரிசையானது சரத்தின் ஒரு பகுதியையோ அரேயில் உள்ள ஒரு உறுப்பையோ கொண்டிருக்கும் எல்லா வரிசைகளையும் வழங்கும்.
NOT CONTAINSநெடுவரிசையானது சரத்தின் ஒரு பகுதியையோ அரேயில் உள்ள ஒரு உறுப்பையோ கொண்டிருக்காத எல்லா வரிசைகளையும் வழங்கும்.

ஆப்பரேட்டர்களைப் பயன்படுத்திப் பகுதிச் சரத்தைப் பொருத்துவதற்கான சில எடுத்துக்காட்டுகளில் பின்வரும் குவெரிகள் அடங்கும்:

FROM sales
  SHOW product_title
  WHERE product_title STARTS WITH 'Summer'
  GROUP BY product_title
FROM sales
  SHOW product_title
  WHERE product_title ENDS WITH 'kit'
  GROUP BY product_title
FROM sales
  SHOW product_title
  WHERE product_title CONTAINS 'Beef'
  GROUP BY product_title

இந்த CONTAINS ஆப்பரேட்டரைப் பயன்படுத்தி அரேக்களுக்குள் உள்ள முழு எண்கள், சரங்கள் மற்றும் தசம எண்கள் உள்ளிட்ட உறுப்புகளைப் பொருத்த முடியும். இந்தப் பொருத்துதலில் பெரிய/சிறிய எழுத்து வடிவம் ஒரு பொருட்டல்ல. அரே பொருத்துதலுக்கு CONTAINS ஐப் பயன்படுத்தும் சில எடுத்துக்காட்டுகளில் பின்வரும் குவெரிகள் அடங்கும்:

FROM sales
  SHOW orders
  WHERE products_bought_together_ids CONTAINS '101'
FROM customers
  SHOW total_number_of_orders
  WHERE customer_cities CONTAINS 'seattle'
FROM sales
  SHOW orders
  WHERE variants_bought_together_variant_prices CONTAINS '10.2'

கருத்துகள்

ShopifyQL அறிக்கைகளின் பிரிவுகளை விளக்க அல்லது ShopifyQL அறிக்கையை இயக்குவதைத் தடுக்க நீங்கள் கருத்துகளைப் பயன்படுத்தலாம். கருத்துப் பிரிவில் உள்ள எந்த உரையையும் இயக்கும்போது அது புறக்கணிக்கப்படும்.

ஒற்றை வரிக் கருத்துகள் -- என்பதில் தொடங்கி, வரியின் இறுதியில் முடிவடையும்.

பல வரிக் கருத்துகள் /* என்பதில் தொடங்கி, இதில் முடிவடையும்: */.

FROM sales
  SHOW average_order_value, gross_sales
  -- the line below has been commented out and won't run
  -- GROUP BY billing_region
  WHERE billing_country = 'United States'
  /*
  this line and the two lines below it have been commented out and won't run
  SINCE 2021-01-01
  UNTIL 2021-12-31
  */

ShopifyQL மூலம் நீங்கள் குவெரி செய்யக்கூடிய பிற தரவு

பின்வரும் தரவைக் குவெரி செய்யவும் ShopifyQL ஐப் பயன்படுத்தலாம்:

பல்வேறு ஸ்டோர்களைக் கொண்டுள்ள நிறுவனங்களுக்கான தரவைக் காண்பித்தல்

உங்கள் ஸ்டோர் Plus அல்லது Enterprise திட்டத்தில் இருந்து, உங்கள் நிறுவனத்தில் பல ஸ்டோர்கள் இருந்தால், பல ஸ்டோர்களின் தரவை ஒரே நேரத்தில் காண்பிக்கும்படி உங்கள் ShopifyQL குவெரியில் சிறிது மாற்றத்தைச் செய்துகொள்ளலாம். FROM என்ற முக்கியச் சொல்லுக்கு அடுத்து ORGANIZATIONவர வேண்டும், அத்துடன் உங்கள் WHERE முக்கியச் சொல்லில் shop_id இடம்பெற்றிருக்க வேண்டும், இது உங்கள் குவெரியில் நீங்கள் சேர்க்க விரும்பும் ஸ்டோர்களுக்கான அளவுருவாக அறிவிக்கப்பட்டிருக்க வேண்டும்.

எடுத்துக்காட்டாக, இந்தக் குவெரியை எழுதுவதன் மூலம் உங்கள் நிறுவனத்திலுள்ள 4 ஸ்டோர்களின் மொத்த விற்பனையைக் கணக்கிட்டுப் பெறலாம்:

FROM ORGANIZATION sales
  SHOW total_sales
  WHERE shop_id IN (12301, 12302, 12303, 12304)

இதில் வடிகட்டுதல்: shop_id என்பதற்கு இது தேவை: FROM ORGANIZATION. உங்கள் நிறுவனத்தில் உள்ள ஒவ்வொரு ஸ்டோருக்கான shop_id மதிப்பைக் கண்டறிய, இதைப் பயன்படுத்தி நிறுவன குவெரியை ரன் செய்யவும்: shop_id:

FROM ORGANIZATION sales
  SHOW total_sales
  GROUP BY shop_name, shop_id

மல்டி-ஸ்டோர் குவெரிகளுக்கும் நிறுவனப் பகுப்பாய்வு அனுமதி தேவை.

மெட்டாஃபீல்டுகள்

உங்கள் ShopifyQL குவெரிகளில் தயாரிப்பு வகையின் மெட்டாஃபீல்டுகள் மற்றும் ஆதரிக்கப்படும் பிரத்தியேக மெட்டாஃபீல்டுகளைப் பரிமாணங்களாகவோ வடிப்பான்களாகவோ பயன்படுத்தலாம்.

ShopifyQL இல் தயாரிப்பு வகையின் மெட்டாஃபீல்டுகள்

வகையின் மெட்டாஃபீல்டுகள், Shopify இன் தரநிலையான தயாரிப்பு வகைப்பாட்டில் உள்ள குறிப்பிட்ட தயாரிப்பு வகைகளுடன் மேப் செய்யப்படும்.

ShopifyQL குவெரிகளில் வகையின் மெட்டாஃபீல்டுகள் புள்ளி (dot) குறியீட்டைப் பயன்படுத்தி வடிவமைக்கப்படுகின்றன. மெட்டாஃபீல்டின் வடிவம்: product.metafields.shopify.{key} ஆகும், இதில் {key} மதிப்பானது material அல்லது size போன்ற குறிப்பிட்ட மெட்டாஃபீல்டு பெயராகும். தரநிலையான வகைப்பாட்டில் உள்ள பல வார்த்தைகளைக் கொண்ட ஹைபனிடப்பட்ட கீகள், எஸ்கேப் செய்யப்பட்ட அடையாளங்காட்டிகளைப் பயன்படுத்துகின்றன. எனவே, மெட்டாஃபீல்டு product.metafields.shopify."color-pattern" அல்லது product.metafields.shopify."age-group" என வடிவமைக்கப்படுகிறது. ஒரு மதிப்புக்கான வகையின் மெட்டாஃபீல்டை வடிகட்ட, CONTAINS அல்லது NOT CONTAINS ஆப்பரேட்டர் தேவைப்படும்.

எடுத்துக்காட்டாக, நீங்கள் தோட்டத்தில் வைக்கக்கூடிய தொட்டிகளை விற்பனை செய்து, உங்கள் தயாரிப்புகளுக்கு Home & Garden > Lawn & Garden > Gardening > Pots & Planters என்ற தரநிலையான வகைப்பாட்டைப் பயன்படுத்தினால், ஒவ்வொரு தொட்டியின் வடிவத்தையும் (உருளை, செவ்வகம், வட்டம் மற்றும் சதுரம் போன்றவை) சேமிக்க Shape என்ற வகையின் மெட்டாஃபீல்டை நீங்கள் பயன்படுத்தலாம். அதன்பின் நீங்கள் product.metafields.shopify.shape என்பதை உங்கள் அறிக்கைகளில் பரிமாணமாகவோ வடிப்பானாகவோ பயன்படுத்தலாம்.

பின்வரும் குவெரியைப் பயன்படுத்தி, "செவ்வக" தயாரிப்புகளை மட்டும் சேர்ப்பதற்குத் தரநிலையான Shape மெட்டாஃபீல்டு மூலம் வடிகட்டப்பட்ட, தயாரிப்பு வாரியான மொத்த விற்பனையைக் காண்பிக்கலாம்:

FROM sales
  SHOW total_sales
  GROUP BY product.title
  WHERE product.metafields.shopify.shape CONTAINS 'Rectangular'

வகையின் மெட்டாஃபீல்டு மூலம் நீங்கள் குழுவாக்கும்போது, அந்த மெட்டாஃபீல்டிற்கான தயாரிப்பின் அனைத்து உள்ளீடுகளும் ஒரே மதிப்பாகக் கருதப்படும். எடுத்துக்காட்டாக, வகையின் Suitable space மெட்டாஃபீல்டிற்கு Indoors மற்றும் Outdoors ஆகிய இரண்டும் ஒரு தொட்டிக்குத் தேர்ந்தெடுக்கப்பட்டிருந்தால், அதன் விற்பனை ஒவ்வொரு இடத்தின் கீழும் தனித்தனியாகக் கணக்கிடப்படுவதற்குப் பதிலாக Indoors, Outdoors என்பதன் கீழ் குழுவாக்கப்படும். Suitable space உள்ளீடு இல்லாத தொட்டிகள் (not set) எனக் குழுவாக்கப்படும்.

பின்வரும் குவெரியைப் பயன்படுத்தி Suitable space வாரியாக உங்கள் மொத்த விற்பனையைக் காண்பிக்கலாம்:

FROM sales
  SHOW total_sales
  GROUP BY product.metafields.shopify."suitable-space"

ShopifyQL இல் பிரத்தியேக மெட்டாஃபீல்டுகள்

ShopifyQL பின்வரும் ஆதார வகைகளுக்கான பிரத்தியேக மெட்டாஃபீல்டுகளை ஆதரிக்கிறது:

  • தயாரிப்புகள்
  • மாறுபாடுகள்
  • வாடிக்கையாளர்கள்
  • ஆர்டர்கள்

பொருந்தக்கூடிய ஒவ்வொரு ஆதார வகைக்கும், பின்வரும் பிரத்தியேக மெட்டாஃபீல்டு வகைகளை ShopifyQL ஆதரிக்கிறது:

  • உரை: single_line_text_field, multi_line_text_field
  • குறிப்பு: product_reference
  • எண்கள்: number_integer, number_decimal, id, rating
  • இணைப்பு: url
  • தேதிகள்: date, date_time
  • மற்றவை: boolean, color
  • வரிசைகள்: list.single_line_text_field, list.multi_line_text_field, list.number_integer, list.number_decimal

மெட்டாஃபீல்டை உருவாக்கும்போது, Shopify அறிக்கைகளில் பரிமாணமாக அல்லது வடிப்பானாக அதைப் பயன்படுத்துவதற்கு முன்பு பகுப்பாய்வில் தரவை வடிகட்டும் அல்லது குழுவாக்கும் விருப்பம் செயல்படுத்தப்பட்டிருக்க வேண்டும்.

ShopifyQL வினவல்களில் பிரத்தியேக மெட்டாஃபீல்டுகள் புள்ளி குறியீட்டைப் பயன்படுத்தி வடிவமைக்கப்பட்டிருக்க வேண்டும். மெட்டாஃபீல்டுக்கான வடிவமைப்பு: {entity}.metafields.{namespace}.{key}. உதாரணத்திற்கு, பாலியஸ்டர், பருத்தி, கைத்தறி மற்றும் நைலான் போன்ற ஒவ்வொரு தயாரிப்பும் எந்த வகையான மெட்டீரியலால் செய்யப்பட்டுள்ளது என்பதைச் சேமிக்க உங்கள் தயாரிப்புகளுக்குப் பிரத்தியேகமான "Material" மெட்டாஃபீல்டை உருவாக்கியிருந்தால், நீங்கள் இதைப் பயன்படுத்தலாம் product.metafields.custom.material என்பதை உங்கள் அறிக்கைகளில் பரிமாணமாகவோ வடிப்பானாகவோ பயன்படுத்தலாம்.

உதாரணத்திற்கு, பின்வரும் வினவலைப் பயன்படுத்தி, "organic cotton" மெட்டீரியலைக் கொண்ட தயாரிப்புகளை மட்டும் சேர்ப்பதற்குப் பிரத்தியேக Material மெட்டாஃபீல்டு மூலம் வடிகட்டப்பட்ட மொத்த விற்பனையைத் தயாரிப்பு வாரியாகக் காட்டலாம்:

FROM sales
  SHOW total_sales
  WHERE product.metafields.custom.material = 'organic cotton'
  GROUP BY product.title

ShopifyQL வினவல்களில் நேரடியாக மெட்டாஃபீல்டு மதிப்புகளையும் உங்களால் அணுக முடியும். உதாரணத்திற்கு, அடுக்கு 2-ஐ விட அதிகமாக இருக்கும் பிரத்தியேக Loyalty tier மெட்டாஃபீல்டுக்கான மதிப்புகளின் அடிப்படையில் வாடிக்கையாளர் தரவை நீங்கள் பகுப்பாய்வு செய்யலாம்:

FROM customers
  SHOW total_amount_spent
  WHERE metafields.custom.loyalty_tier > 2
  GROUP BY metafields.custom.loyalty_tier

முந்தைய உதாரணத்தில், customers ஆதார உட்பொருள் இதில் அறிவிக்கப்பட்டுள்ளது FROM அறிக்கை, எனவே இதை மீண்டும் இதில் சேர்க்க வேண்டிய அவசியமில்லை GROUP BY அல்லது WHERE கூற்றுகள்.

செயலி நிகழ்வுகள்

மார்க்கெட்டிங் செயலி மூலம் அனுப்பப்பட்ட மின்னஞ்சல் அல்லது லாயல்டி செயலியில் பெறப்பட்ட வெகுமதி போன்று உங்கள் ஸ்டோரில் நிறுவப்பட்ட செயலிகள் Shopify-க்கு நிகழ்வுகளை அனுப்பலாம். இவற்றை வினவுவதன் மூலம் அந்த நிகழ்வுகள் குறித்து நீங்கள் அறிக்கை பெறலாம் FROM app_events, மற்றும் அவற்றைச் செயலி அல்லது கால அளவின் அடிப்படையில் குழுவாக்கலாம்.

நீங்கள் வினவக்கூடிய செயலி நிகழ்வுத் தரவு என்பது, உங்கள் ஸ்டோரில் நிறுவப்பட்டுள்ள செயலிகள் மற்றும் ஒவ்வொரு செயலியின் டெவலப்பரும் Shopify-க்கு நிகழ்வுகளை அனுப்புகிறாரா என்பதைப் பொறுத்தது.

செயலிகள் நிலையான நிகழ்வுகளை அனுப்ப முடியும், அவை shopify.marketing.email_sent போன்று shopify.{category}.{event} என வடிவமைக்கப்பட்ட நிகழ்வுப் பெயரைப் பயன்படுத்தும். ஒவ்வொரு நிகழ்விற்கும் அதன் சொந்த அளவீடுகளும் பரிமாணங்களும் உள்ளன. உதாரணமாக, shopify.marketing.email_sent நிகழ்வில் emails_sent அளவீடும், campaign_id மற்றும் message_type போன்ற பரிமாணங்களும் உள்ளன.

ஒவ்வொரு செயலி நிகழ்வுக்கும் கிடைக்கும் புலங்களைப் பற்றி அறிய, பின்வரும் அட்டவணையைச் சரிபார்க்கவும்.

நிகழ்வை அனுப்பிய செயலியின் பெயர் போன்ற ஒவ்வொரு செயலி நிகழ்வுக்கும் கிடைக்கும் ShopifyQL புலங்களின் பட்டியல்.
புலம்வகைவிளக்கம்
app_nameபரிமாணம்நிகழ்வை அனுப்பிய செயலியின் பெயர். செயலிகள் முழுவதிலும் உள்ள ஒரே அளவீட்டை ஒப்பிட, இந்தப் புலத்தின்படி குழுவாக்கவும்.
event_handleபரிமாணம்நிகழ்வின் பெயர், இது போன்று shopify.marketing.email_sent.
event_countஅளவீடுசெயலிகள் அனுப்பிய நிகழ்வுகளின் எண்ணிக்கை.
latest_event_timestampஅளவீடுமிகச் சமீபத்திய நிகழ்வின் தேதியும் நேரமும்.

உதாரணமாக, கடந்த 30 நாட்களில் உங்களின் ஒவ்வொரு மார்க்கெட்டிங் செயலியும் அனுப்பிய மின்னஞ்சல்களின் எண்ணிக்கையை ஒப்பிட, உங்களின் வினவல்:

FROM app_events
  SHOW emails_sent
  GROUP BY app_name
  TIMESERIES day
  SINCE -30d

நீங்கள் app_events தரவுத்தொகுப்பை அதே வினவலில் மற்றொரு தரவுத்தொகுப்புடன் சேர்த்து வினவ முடியாது. உதாரணமாக, FROM sales, app_events ஆதரிக்கப்படாது.

ShopifyQL இல் தனிப்பயன் செயலி நிகழ்வுகள்

நிலையான நிகழ்வுகள் மட்டுமின்றி, சில செயலிகள் தங்களுக்கான குறிப்பிட்ட அளவீடுகள் மற்றும் பரிமாணங்களுடன் தங்களின் சொந்தத் தனிப்பயன் நிகழ்வுகளை வரையறுக்கின்றன. உதாரணமாக, bookings என்ற ஹேண்டிலைக் கொண்ட ஒரு முன்பதிவுச் செயலி, appointment_booked என்ற நிகழ்வை வரையறுக்கலாம். அந்த நிகழ்வில் வாடிக்கையாளர்கள் செய்யும் முன்பதிவுகளின் எண்ணிக்கைக்காக appointments அளவீடும், ஒவ்வொரு முன்பதிவும் எந்தச் சேவைக்கானது என்பதைக் குறிக்க service_type பரிமாணமும் இருக்கலாம்.

ShopifyQL வினவல்களில், தனிப்பயன் செயலி நிகழ்வின் புலங்களை புள்ளி குறியீட்டைப் பயன்படுத்தி வடிவமைக்கவும்: event.{app}.{event}.{field}. {app} பகுதியானது, செயலியின் டெவலப்பர் தேர்வுசெய்வதைப் பொறுத்து அந்தச் செயலியின் ஹேண்டில் அல்லது API விசையாக இருக்கும். உதாரணமாக, முன்பதிவுச் செயலியின் appointments அளவீடு event.bookings.appointment_booked.appointments என இருக்கும்.

புலத்தின் பெயரில் சிறுகோடு (hyphen) இடம்பெற்றிருந்தால், அந்தப் பகுதியை நீங்கள் இரட்டை மேற்கோள் குறிகளுக்குள் (") கொடுக்க வேண்டும். உதாரணமாக, முன்பதிவுச் செயலியின் ஹேண்டில் bookings-app எனில், புலம் event."bookings-app".appointment_booked.appointments என இருக்கும்.

தனிப்பயன் செயலி நிகழ்வின் ஒவ்வொரு புலமும், அதை வரையறுக்கும் நிகழ்வுக்கு மட்டுமே கிடைக்கும். event_handle பரிமாணத்தில், தனிப்பயன் நிகழ்வுகள் bookings.appointment_booked போன்ற {app}.{event} என்ற பெயரைப் பயன்படுத்துகின்றன.

வினவல் முடிவுகளிலும் CSV ஏற்றுமதிகளிலும், தனிப்பயன் செயலி நிகழ்வுகளின் புலங்கள் அந்தச் செயலி வழங்கும் லேபிள்களைப் பயன்படுத்துகின்றன.

தனிப்பயன் செயலி நிகழ்வுகளின் பரிமாணங்கள் கடந்த 30 நாட்களுக்கான தரவுகளுக்கு மட்டுமே கிடைக்கும். உங்கள் வினவல், ஒரு பரிமாணத்தின்படி தரவைக் குழுவாக்கினால் அல்லது வடிகட்டினால், SINCE -7d போன்று கடந்த 30 நாட்களுக்குள் தொடங்கும் ஒரு தேதி வரம்பைப் பயன்படுத்தவும்.

உதாரணமாக, கடந்த 7 நாட்களில் ஒவ்வொரு வகையான சேவைக்கும் வாடிக்கையாளர்கள் செய்த முன்பதிவுகளின் எண்ணிக்கையை ஒப்பிடுவதற்கு, உங்களின் வினவல் கீழே கொடுக்கப்பட்டுள்ளது:

FROM app_events
  SHOW event.bookings.appointment_booked.appointments
  GROUP BY event.bookings.appointment_booked.service_type
  TIMESERIES day
  SINCE -7d

மெட்டாஆப்ஜெக்ட்டுகள்

ஆதரிக்கப்படும் ஆதார வகையிலுள்ள மெட்டாஃபீல்டு மூலம் மெட்டாஆப்ஜெக்ட் குறிப்பிடப்படும்போது, உங்களின் ShopifyQL வினவல்களில் மெட்டாஆப்ஜெக்ட்டுகளில் உள்ள புலங்களைப் பரிமாணங்களாகவோ வடிப்பான்களாகவோ பயன்படுத்தலாம். பின்வரும் ஆதார வகைகளுக்கான மெட்டாஆப்ஜெக்ட் புலங்களை ShopifyQL ஆதரிக்கிறது:

  • தயாரிப்புகள்
  • மாறுபாடுகள்
  • வாடிக்கையாளர்கள்
  • ஆர்டர்கள்

குறிப்பிடும் மெட்டாஃபீல்டு ஒற்றை மெட்டாஆப்ஜெக்ட் குறிப்பையோ மெட்டாஆப்ஜெக்ட் குறிப்புகளின் பட்டியலையோ கொண்டிருக்க வேண்டும். கலப்பு குறிப்பு மெட்டாஃபீல்டு மூலம் குறிப்பிடப்படும் மெட்டாஆப்ஜெக்ட்டிலுள்ள புலங்களை வினவலில் பயன்படுத்த முடியாது. மேலும், எல்லா மெட்டாஆப்ஜெக்ட் புல வகைகளும் ஆதரிக்கப்படுவதில்லை.

மெட்டாஆப்ஜெக்ட் புலத்துடன் குறிப்பிடும் மெட்டாஃபீல்டை நீட்டிக்கும் புள்ளி குறியீட்டைப் பயன்படுத்தி, மெட்டாஆப்ஜெக்ட் புலங்கள் வடிவமைக்கப்படுகின்றன. இதன் வடிவமைப்பு: {entity}.metafields.{namespace}.{key}.{field}. இதில் {namespace}.{key} என்பது குறிப்பு மெட்டாஃபீல்டு, {field} என்பது நீங்கள் பயன்படுத்த விரும்பும் மெட்டாஆப்ஜெக்ட் புலம்.

உதாரணமாக, உங்கள் தயாரிப்புகள் பிரத்தியேக designer மெட்டாஃபீல்டின் மூலம் Designer மெட்டாஆப்ஜெக்ட்டைக் குறிப்பிடுவதாகவும், அந்த மெட்டாஆப்ஜெக்ட்டில் country புலம் இருப்பதாகவும் வைத்துக்கொள்வோம். பின்வரும் வினவலைப் பயன்படுத்தி டிசைனரின் நாடு வாரியாகக் குழுவாக்கப்பட்ட மொத்த விற்பனையைக் காட்டலாம்:

FROM sales
  SHOW total_sales
  GROUP BY product.metafields.custom.designer.country