[{"data":1,"prerenderedAt":839},["ShallowReactive",2],{"navigation":3,"/query/query-notes":203},[4,22,47,64,101,126,143,156,169,190],{"title":5,"path":6,"stem":7,"children":8,"page":21},"آشنایی و مبانی","/intro","01.intro",[9,13,17],{"title":10,"path":11,"stem":12},"معماری داده‌ها","/intro/architecture","01.intro/1.architecture",{"title":14,"path":15,"stem":16},"الگوهای پیشنهادی","/intro/best-practices","01.intro/2.best-practices",{"title":18,"path":19,"stem":20},"مقایسه ETL و ELT","/intro/etl-vs-elt","01.intro/3.etl-vs-elt",false,{"title":23,"path":24,"stem":25,"children":26,"page":21},"ساخت و مدیریت فضا","/space","02.space",[27,31,35,39,43],{"title":28,"path":29,"stem":30},"ساختار فضا و پروژه","/space/structure","02.space/1.structure",{"title":32,"path":33,"stem":34},"ذخیره در باکت اختصاصی","/space/dedicated-bucket","02.space/2.dedicated-bucket",{"title":36,"path":37,"stem":38},"آموزش ساخت فضا","/space/create-space","02.space/3.create-space",{"title":40,"path":41,"stem":42},"طرح فضا","/space/plan","02.space/4.plan",{"title":44,"path":45,"stem":46},"سرور MCP","/space/mcp-server","02.space/5.mcp-server",{"title":48,"path":49,"stem":50,"children":51,"page":21},"مدیریت کاربران","/user-management","03.user-management",[52,56,60],{"title":53,"path":54,"stem":55},"آشنایی با نقش‌ها","/user-management/roles","03.user-management/1.roles",{"title":57,"path":58,"stem":59},"اعطای دسترسی","/user-management/access","03.user-management/2.access",{"title":61,"path":62,"stem":63},"آموزش اعطای دسترسی","/user-management/manage-users","03.user-management/3.manage-users",{"title":65,"path":66,"stem":67,"children":68,"page":21},"ایجاد و مدیریت دیتاست","/dataset","04.dataset",[69,73,77,81,85,89,93,97],{"title":70,"path":71,"stem":72},"ایجاد دیتاست","/dataset/create-dataset","04.dataset/1.create-dataset",{"title":74,"path":75,"stem":76},"الگوهای نام‌گذاری","/dataset/naming-conventions","04.dataset/2.naming-conventions",{"title":78,"path":79,"stem":80},"تفاوت درج با ورژن و آپدیت","/dataset/write-modes","04.dataset/3.write-modes",{"title":82,"path":83,"stem":84},"انواع ستون و نوع مقدار","/dataset/column-types","04.dataset/4.column-types",{"title":86,"path":87,"stem":88},"متادیتا و ویژگی‌های ستون","/dataset/column-settings","04.dataset/5.column-settings",{"title":90,"path":91,"stem":92},"قوانین امنیتی جدول","/dataset/table-settings","04.dataset/6.table-settings",{"title":94,"path":95,"stem":96},"ویرایش اسکیما","/dataset/schema-evolution","04.dataset/7.schema-evolution",{"title":98,"path":99,"stem":100},"آموزش ایجاد جدول سفارشی","/dataset/create-custom-table","04.dataset/8.create-custom-table",{"title":102,"path":103,"stem":104,"children":105,"page":21},"لود داده","/data-load","05.data-load",[106,110,114,118,122],{"title":107,"path":108,"stem":109},"لندر گو (Lander Go)","/data-load/lander-go","05.data-load/1.lander-go",{"title":111,"path":112,"stem":113},"لود مستقیم (API)","/data-load/api-load","05.data-load/2.api-load",{"title":115,"path":116,"stem":117},"لود با تبدیل (Transform)","/data-load/transform-load","05.data-load/3.transform-load",{"title":119,"path":120,"stem":121},"یکتاسازی و مدیریت Late Data","/data-load/idempotency-and-late-data","05.data-load/4.idempotency-and-late-data",{"title":123,"path":124,"stem":125},"لاگ درخواست‌های رد شده","/data-load/dropped-requests","05.data-load/5.dropped-requests",{"title":127,"path":128,"stem":129,"children":130,"page":21},"داشبورد","/dashboard","06.dashboard",[131,135,139],{"title":132,"path":133,"stem":134},"ساختار و دسترسی","/dashboard/structure","06.dashboard/1.structure",{"title":136,"path":137,"stem":138},"فیلترهای استوری","/dashboard/story-filters","06.dashboard/2.story-filters",{"title":140,"path":141,"stem":142},"آموزش ساخت استوری","/dashboard/create-story","06.dashboard/3.create-story",{"title":144,"path":145,"stem":146,"children":147,"page":21},"کوئری","/query","07.query",[148,152],{"title":149,"path":150,"stem":151},"نکات نوشتن کوئری","/query/query-notes","07.query/1.query-notes",{"title":153,"path":154,"stem":155},"توابع اختصاصی داده‌لند","/query/dadeland-sql","07.query/2.dadeland-sql",{"title":157,"path":158,"stem":159,"children":160,"page":21},"فانل","/funnel","08.funnel",[161,165],{"title":162,"path":163,"stem":164},"آموزش ایجاد فانل","/funnel/create-funnel","08.funnel/1.create-funnel",{"title":166,"path":167,"stem":168},"شیوه کار فانل","/funnel/how-funnel-works","08.funnel/2.how-funnel-works",{"title":170,"path":171,"stem":172,"children":173,"page":21},"ماژول کلاینت","/client-module","09.client-module",[174,178,182,186],{"title":175,"path":176,"stem":177},"آشنایی با ماژول کلاینت","/client-module/intro","09.client-module/1.intro",{"title":179,"path":180,"stem":181},"تنظیمات ماژول","/client-module/settings","09.client-module/2.settings",{"title":183,"path":184,"stem":185},"جمع‌آوری داده (لندر وب)","/client-module/lander-web","09.client-module/3.lander-web",{"title":187,"path":188,"stem":189},"آموزش راه‌اندازی","/client-module/up-and-running","09.client-module/4.up-and-running",{"title":191,"path":192,"stem":193,"children":194,"page":21},"عملیات","/activation","10.activation",[195,199],{"title":196,"path":197,"stem":198},"توزیع داده (Reverse ETL)","/activation/reverse-etl","10.activation/1.reverse-etl",{"title":200,"path":201,"stem":202},"یکپارچه‌سازی‌های توزیع داده","/activation/integrations","10.activation/2.integrations",{"id":204,"title":149,"body":205,"description":832,"extension":833,"links":834,"meta":835,"navigation":836,"path":150,"seo":837,"stem":151,"__hash__":838},"docs/07.query/1.query-notes.md",{"type":206,"value":207,"toc":820},"minimark",[208,213,217,220,224,264,266,269,276,278,282,304,330,341,343,347,357,403,405,409,421,441,444,538,584,629,678,771],[209,210,212],"h3",{"id":211},"پشتیبانی-از-mysql","پشتیبانی از MySQL",[214,215,216],"p",{},"در داده‌لند امکان استفاده از سینتکس و توابع نسخه ۸ پایگاه داده MySQL وجود دارد. موتور کوئری داده‌لند این دستورات را جهت اجرا به فرمت تحلیلی زیرساخت تبدیل می‌نماید.",[218,219],"hr",{},[209,221,223],{"id":222},"انحصار-دستور-select","انحصار دستور SELECT",[214,225,226,227,235,236,241,242,241,247,241,252,257,258,263],{},"در صفحه کوئری منحصراً دستور ",[228,229,231],"span",{"dir":230},"ltr",[232,233,234],"code",{},"SELECT"," برای استخراج و تحلیل داده‌ها اجرا می‌شود. دستورات تغییر ساختار یا تغییر داده (نظیر ",[228,237,238],{"dir":230},[232,239,240],{},"INSERT","، ",[228,243,244],{"dir":230},[232,245,246],{},"UPDATE",[228,248,249],{"dir":230},[232,250,251],{},"DELETE",[228,253,254],{"dir":230},[232,255,256],{},"DROP"," و ",[228,259,260],{"dir":230},[232,261,262],{},"ALTER",") در این محیط مسدود هستند و مدیریت آن‌ها از طریق بخش‌های مربوطه در رابط کاربری انجام می‌پذیرد.",[218,265],{},[209,267,153],{"id":268},"توابع-اختصاصی-دادهلند",[214,270,271,272,275],{},"علاوه بر توابع استاندارد، توابع اختصاصی متعددی برای سهولت در محاسبات و تبدیل‌های تاریخی توسعه داده شده است (جهت بررسی فهرست توابع، به راهنمای ",[273,274,153],"a",{"href":154}," مراجعه نمایید).",[218,277],{},[209,279,281],{"id":280},"لیمیت-سیستمی","لیمیت سیستمی",[214,283,284,285,290,291,295,296,299,300,303],{},"در صورت عدم تعیین بند ",[228,286,287],{"dir":230},[232,288,289],{},"LIMIT"," در کوئری، سیستم به صورت پیش‌فرض لیمیت ",[292,293,294],"strong",{},"۱۰۰۰ ردیفی"," را صرفاً جهت پیش‌نمایش سریع خروجی اعمال می‌کند. این لیمیت سیستمی بر فرآیند ",[292,297,298],{},"ساخت ویجت"," یا ",[292,301,302],{},"دانلود داده‌ها"," اثری ندارد و محاسبات آن‌ها بر روی کل داده‌های خروجی کوئری انجام می‌گیرد:",[305,306,307,318,324],"ul",{},[308,309,310,313,314,317],"li",{},[292,311,312],{},"پیش‌نمایش در صفحه کوئری:"," صرفاً ",[292,315,316],{},"۱۰۰۰ ردیف"," اول خروجی نمایش داده می‌شود.",[308,319,320,323],{},[292,321,322],{},"ساخت ویجت:"," تمامی محاسبات و نمودارها بر مبنای کل ردیف‌های خروجی کوئری شکل می‌گیرند.",[308,325,326,329],{},[292,327,328],{},"دانلود داده:"," فایل خروجی شامل تمامی ردیف‌های حاصل از کوئری خواهد بود.",[331,332,333],"note",{},[214,334,335,336,340],{},"در صورت درج دستی دستور ",[228,337,338],{"dir":230},[232,339,289],{}," در متن کوئری، این محدودیت در تمامی بخش‌ها (شامل ساخت ویجت و دانلود فایل) اعمال خواهد شد.",[218,342],{},[209,344,346],{"id":345},"تطابق-با-فیلتر-هوشمند","تطابق با فیلتر هوشمند",[214,348,349,350,353,354,356],{},"جهت هماهنگی کوئری با ",[292,351,352],{},"فیلترهای هوشمند استوری","، موارد زیر را در نگارش کوئری لحاظ فرمایید (مراجعه به راهنمای ",[273,355,136],{"href":137},"):",[305,358,359,371,391],{},[308,360,361,364,365,370],{},[292,362,363],{},"ارجاع به جداول فیزیکی:"," فیلترهای استوری منحصراً روی جداول فیزیکی اعمال می‌شوند؛ بنابراین داده‌های نیازمند فیلتر نباید داخل جداول مجازی (مانند CTE یا ",[228,366,367],{"dir":230},[232,368,369],{},"WITH",") تعریف گردند.",[308,372,373,379,380,299,385,390],{},[292,374,375,376,356],{},"مستثنی‌سازی با بک‌تیک (",[232,377,378],{},"`"," قرار دادن نام جدول درون بک‌تیک در بندهای ",[228,381,382],{"dir":230},[232,383,384],{},"FROM",[228,386,387],{"dir":230},[232,388,389],{},"JOIN","، آن ارجاع را از اعمال خودکار فیلترهای استوری معاف می‌سازد.",[308,392,393,396,397,402],{},[292,394,395],{},"اولویت فیلتر ثابت:"," شروط تعریف‌شده در بند ",[228,398,399],{"dir":230},[232,400,401],{},"WHERE"," به عنوان فیلتر ثابت اولویت دارند و مانع تزریق فیلتر استوری روی همان ستون می‌شوند.",[218,404],{},[209,406,408],{"id":407},"ساخت-ویجت-از-کوئری","ساخت ویجت از کوئری",[214,410,411,412,415,416,420],{},"موتور ویجت‌ساز داده‌لند ساختاری ",[292,413,414],{},"ستون‌محور (Column-oriented)"," دارد؛ به این معنا که تمامی ابعاد و مقادیر مورد نیاز برای رسم نمودارها باید در قالب ستون‌های مشخص در خروجی دستور ",[228,417,418],{"dir":230},[232,419,234],{}," استخراج شوند:",[305,422,423,429],{},[308,424,425,428],{},[292,426,427],{},"پشتیبانی از ستون‌های JSON:"," امکان انتخاب کلیدهای داخل ستون‌های JSON به عنوان ستون مبدأ یا ستون گروه‌بندی فراهم است.",[308,430,431,434,435,440],{},[292,432,433],{},"انعطاف در گروه‌بندی:"," گروه‌بندی و محاسبات تجمیعی می‌تواند درون دستور SQL (با ",[228,436,437],{"dir":230},[232,438,439],{},"GROUP BY",") انجام شود یا رکوردهای خام استخراج گردیده و گروه‌بندی به ویجت‌ساز سپرده شود؛ نتیجه نهایی در هر دو حالت یکسان است.",[214,442,443],{},"متناسب با نوع ویجت انتخابی، الزامات ستون‌های ورودی در خروجی کوئری به شرح زیر است:",[445,446,453,456,475,478],"collapsible",{":ui":447,"className":448,"close-text":451,"name":452,"open-text":451},"{\"trigger\": \"text-base\", \"triggerIcon\": \"size-5\"}",[449,450],"[&_button]:!text-base","[&_svg]:!size-5"," ","ویجت جدول",[214,454,455],{},"در داده‌لند دو شیوه برای ایجاد ویجت جدول وجود دارد:",[305,457,458,469],{},[308,459,460,463,464,468],{},[292,461,462],{},"جدول مستقیم از کوئری (SQL Table):"," در صفحه کوئری، می‌توانید کل خروجی حاصل از دستور ",[228,465,466],{"dir":230},[232,467,234],{}," را بدون هیچ‌گونه محدودیت یا الزام در تعداد یا نوع ستون‌ها، مستقیماً به عنوان ویجت جدول در استوری ذخیره نمایید. این حالت برای نمایش گزارش‌های خام و سوابق بدون نیاز به محاسبات تجمیعی کاربرد دارد.",[308,470,471,474],{},[292,472,473],{},"جدول محاسباتی در ویجت‌ساز (Builder Table):"," این شیوه در ویجت‌ساز انتخاب می‌شود و محاسبات تجمیعی را طبق جدول زیر بر روی ستون‌ها اعمال می‌نماید:",[476,477],"br",{},[479,480,481,502],"table",{},[482,483,484],"thead",{},[485,486,487,492,496,499],"tr",{},[488,489,491],"th",{"align":490},"left","نوع محاسبه",[488,493,495],{"align":494},"center","تعداد ستون",[488,497,498],{"align":490},"نوع ستون‌های ورودی",[488,500,501],{"align":490},"محاسبه و خروجی",[503,504,505,522],"tbody",{},[485,506,507,513,516,519],{},[508,509,510],"td",{"align":490},[292,511,512],{},"فراوانی مقادیر یکتا",[508,514,515],{"align":494},"۱",[508,517,518],{"align":490},"تمامی انواع ستون یا کلیدهای JSON",[508,520,521],{"align":490},"مقادیر یکتای ستون انتخاب‌شده را استخراج می‌کند و فراوانی هر مقدار را به تفکیک تعداد و درصد نمایش می‌دهد.",[485,523,524,529,532,535],{},[508,525,526],{"align":490},[292,527,528],{},"جمع و میانگین",[508,530,531],{"align":494},"۲",[508,533,534],{"align":490},"ستون مبدأ عددی + ستون گروه‌بندی",[508,536,537],{"align":490},"داده‌ها را بر مبنای ستون دوم گروه‌بندی می‌نماید و حاصل جمع یا میانگین مقادیر عددی را محاسبه می‌کند.",[445,539,542],{":ui":447,"className":540,"close-text":451,"name":541,"open-text":451},[449,450],"ویجت پای چارت",[479,543,544,556],{},[482,545,546],{},[485,547,548,550,552,554],{},[488,549,491],{"align":490},[488,551,495],{"align":494},[488,553,498],{"align":490},[488,555,501],{"align":490},[503,557,558,571],{},[485,559,560,564,566,568],{},[508,561,562],{"align":490},[292,563,512],{},[508,565,515],{"align":494},[508,567,518],{"align":490},[508,569,570],{"align":490},"مقادیر یکتای ستون انتخابی را استخراج می‌کند و فراوانی هر مقدار را به تفکیک تعداد و درصد در نمودار نمایش می‌دهد.",[485,572,573,577,579,581],{},[508,574,575],{"align":490},[292,576,528],{},[508,578,531],{"align":494},[508,580,534],{"align":490},[508,582,583],{"align":490},"داده‌ها را بر مبنای ستون دوم گروه‌بندی نموده و حاصل جمع یا میانگین مقادیر عددی را به ازای هر دسته محاسبه می‌کند.",[445,585,588],{":ui":447,"className":586,"close-text":451,"name":587,"open-text":451},[449,450],"ویجت بار چارت",[479,589,590,602],{},[482,591,592],{},[485,593,594,596,598,600],{},[488,595,491],{"align":490},[488,597,495],{"align":494},[488,599,498],{"align":490},[488,601,501],{"align":490},[503,603,604,617],{},[485,605,606,610,612,614],{},[508,607,608],{"align":490},[292,609,512],{},[508,611,515],{"align":494},[508,613,518],{"align":490},[508,615,616],{"align":490},"مقادیر یکتای ستون انتخابی را استخراج می‌کند و فراوانی هر مقدار را به تفکیک تعداد در نمودار نمایش می‌دهد.",[485,618,619,623,625,627],{},[508,620,621],{"align":490},[292,622,528],{},[508,624,531],{"align":494},[508,626,534],{"align":490},[508,628,583],{"align":490},[445,630,633],{":ui":447,"className":631,"close-text":451,"name":632,"open-text":451},[449,450],"ویجت بار چارت انباشته",[479,634,635,647],{},[482,636,637],{},[485,638,639,641,643,645],{},[488,640,491],{"align":490},[488,642,495],{"align":494},[488,644,498],{"align":490},[488,646,501],{"align":490},[503,648,649,663],{},[485,650,651,655,657,660],{},[508,652,653],{"align":490},[292,654,512],{},[508,656,531],{"align":494},[508,658,659],{"align":490},"ستون مبدأ + ستون محور افقی",[508,661,662],{"align":490},"مقادیر یکتای ستون مبدأ را استخراج نموده و فراوانی هر مقدار را به تفکیک دسته‌های محور افقی به صورت انباشته نمایش می‌دهد.",[485,664,665,669,672,675],{},[508,666,667],{"align":490},[292,668,528],{},[508,670,671],{"align":494},"۳",[508,673,674],{"align":490},"ستون مبدأ عددی + ستون گروه‌بندی + ستون محور افقی",[508,676,677],{"align":490},"داده‌ها را بر مبنای محور افقی و ستون گروه‌بندی تفکیک می‌کند و مجموع یا میانگین مقادیر عددی را به صورت بخش‌های انباشته محاسبه می‌نماید.",[445,679,682,726,728,733,761,763],{":ui":447,"className":680,"close-text":451,"name":681,"open-text":451},[449,450],"ویجت لاین چارت",[479,683,684,696],{},[482,685,686],{},[485,687,688,690,692,694],{},[488,689,491],{"align":490},[488,691,495],{"align":494},[488,693,498],{"align":490},[488,695,501],{"align":490},[503,697,698,712],{},[485,699,700,704,706,709],{},[508,701,702],{"align":490},[292,703,512],{},[508,705,531],{"align":494},[508,707,708],{"align":490},"ستون مبدأ + ستون محور افقی (تاریخ یا زمان)",[508,710,711],{"align":490},"مقادیر یکتای ستون مبدأ را استخراج نموده و فراوانی هر مقدار را در طول محور زمان به صورت خطوط پیوسته نمایش می‌دهد.",[485,713,714,718,720,723],{},[508,715,716],{"align":490},[292,717,528],{},[508,719,671],{"align":494},[508,721,722],{"align":490},"ستون مبدأ عددی + ستون گروه‌بندی + ستون محور افقی (تاریخ یا زمان)",[508,724,725],{"align":490},"داده‌ها را بر مبنای محور زمان و ستون گروه‌بندی تفکیک می‌کند و حاصل جمع یا میانگین مقادیر را در قالب خطوط مجزا در طول زمان نمایش می‌دهد.",[476,727],{},[214,729,730],{},[292,731,732],{},"تنظیمات محور افقی:",[305,734,735,749,755],{},[308,736,737,740,741,744,745,748],{},[292,738,739],{},"نوع ستون:"," ستون محور افقی منحصراً باید از نوع تاریخ ",[232,742,743],{},"DATE","، تاریخ و ساعت ",[232,746,747],{},"DATETIME"," یا کلید معتبر زمانی در ستون JSON باشد.",[308,750,751,754],{},[292,752,753],{},"بازه زمانی:"," امکان نمایش در چهار سطح «ماه» (نام ماه)، «روز» (تاریخ کامل)، «روزهای هفته» (نام روز) و «ساعت» (ساعت‌های شبانه‌روز از ۰ تا ۲۳ برای مقادیر دارای زمان) فراهم است.",[308,756,757,760],{},[292,758,759],{},"تقویم:"," امکان نمایش برچسب‌های زمانی بر مبنای تقویم شمسی یا میلادی وجود دارد.",[476,762],{},[331,764,765],{},[214,766,767,768,770],{},"برای استخراج بازه‌های زمانی و تبدیل تاریخ به شمسی، دو رویکرد با نتیجه یکسان وجود دارد: می‌توانید این تبدیل‌ها را مستقیماً در کوئری SQL با کمک ",[273,769,153],{"href":154}," انجام دهید، یا ستون خام تاریخ را انتخاب کرده و استخراج سطوح زمانی و تبدیل به تقویم شمسی را به ویجت‌ساز بسپارید.",[445,772,775],{":ui":447,"className":773,"close-text":451,"name":774,"open-text":451},[449,450],"ویجت شماره",[479,776,777,789],{},[482,778,779],{},[485,780,781,783,785,787],{},[488,782,491],{"align":490},[488,784,495],{"align":494},[488,786,498],{"align":490},[488,788,501],{"align":490},[503,790,791,805],{},[485,792,793,798,800,802],{},[508,794,795],{"align":490},[292,796,797],{},"تعداد کل و تعداد یکتا",[508,799,515],{"align":494},[508,801,518],{"align":490},[508,803,804],{"align":490},"تعداد کل ردیف‌ها یا تعداد مقادیر متمایز ستون را به عنوان یک شاخص عددی بزرگ نمایش می‌دهد.",[485,806,807,812,814,817],{},[508,808,809],{"align":490},[292,810,811],{},"توابع ریاضی (مجموع، میانگین، کمینه، بیشینه)",[508,813,515],{"align":494},[508,815,816],{"align":490},"ستون مبدأ عددی یا کلید عددی JSON",[508,818,819],{"align":490},"عملیات ریاضی و آماری را بر روی مقادیر ستون عددی محاسبه کرده و به عنوان شاخص عددی بزرگ نمایش می‌دهد.",{"title":821,"searchDepth":822,"depth":823,"links":824},"",1,2,[825,827,828,829,830,831],{"id":211,"depth":826,"text":212},3,{"id":222,"depth":826,"text":223},{"id":268,"depth":826,"text":153},{"id":280,"depth":826,"text":281},{"id":345,"depth":826,"text":346},{"id":407,"depth":826,"text":408},"در این صفحه با نکات کلیدی نگارش کوئری‌های بهینه، لیمیت سیستمی و الزامات ساخت انواع ویجت آشنا می‌شوید.","md",null,{},true,{"title":149,"description":832},"zDPczZWA9C8GHf_s2G4nqqncatYSO8erkoy09xbLEsM",1793189280775]