جدول محوری
یک جدول محوری
نمایندگی JSON |
---|
{ "rows": [ { object ( |
فیلدها | |
---|---|
rows[] | گروه بندی هر ردیف در جدول محوری. |
columns[] | هر ستون در جدول محوری گروه بندی می شود. |
criteria | نگاشت اختیاری فیلترها در هر ستون منبع. فیلترها قبل از جمع آوری داده ها در جدول محوری اعمال می شوند. کلید نقشه، فاصله ستونی محدوده منبعی است که میخواهید فیلتر کنید، و مقدار، معیار آن ستون است. به عنوان مثال، اگر منبع این فیلد به نفع |
filterSpecs[] | فیلترها قبل از جمعآوری دادهها برای جدول محوری روی ستونهای منبع اعمال میشوند. هم |
values[] | لیستی از مقادیری که باید در جدول محوری گنجانده شوند. |
valueLayout | آیا مقادیر باید به صورت افقی (به عنوان ستون) یا عمودی (به عنوان ردیف) فهرست شوند. |
dataExecutionStatus | فقط خروجی وضعیت اجرای داده برای جداول محوری منبع داده. |
source_data فیلد اتحادیه. منبع داده های جدول محوری. source_data می تواند تنها یکی از موارد زیر باشد: | |
source | محدوده ای که جدول محوری داده ها را از آن می خواند. |
dataSourceId | شناسه منبع داده که جدول محوری دادهها را از آن میخواند. |
PivotGroup
یک گروه بندی واحد (اعم از ردیف یا ستون) در جدول محوری.
نمایندگی JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
فیلدها | |
---|---|
showTotals | درست است اگر جدول محوری باید مجموع این گروه بندی را شامل شود. |
valueMetadata[] | فراداده در مورد مقادیر در گروه بندی. |
sortOrder | به ترتیب مقادیر در این گروه باید مرتب شوند. |
valueBucket | سطل گروه محوری مقابل برای مرتبسازی. اگر مشخص نشده باشد، مرتبسازی بر اساس مقادیر این گروه حروف الفبا است. |
repeatHeadings | درست است اگر عناوین در این گروه محوری باید تکرار شوند. این فقط برای گروه بندی ردیف ها معتبر است و توسط ستون ها نادیده گرفته می شود. بهطور پیشفرض، ما تکرار سرفصلها را با نشان ندادن سرفصلهای سطح بالاتر در جایی که یکسان هستند، به حداقل میرسانیم. به عنوان مثال، حتی اگر ردیف سوم زیر با "Q1 Mar" مطابقت دارد، "Q1" نشان داده نمی شود زیرا با ردیف های قبلی اضافی است. تنظیم repeatHeadings روی true باعث می شود "Q1" برای "Feb" و "Mar" تکرار شود.
|
label | برچسب هایی برای استفاده برای گروه های سطر/ستون که می توانند سفارشی شوند. به عنوان مثال، در جدول محوری زیر، برچسب ردیف
|
groupRule | قانون گروه برای اعمال این گروه سطر/ستون. |
groupLimit | محدودیت تعداد ردیفها یا ستونها برای اعمال این گروه محوری. |
source میدان اتحادیه منبع داده گروه محوری. source می تواند تنها یکی از موارد زیر باشد: | |
sourceColumnOffset | افست ستونی محدوده منبع که این گروه بندی بر اساس آن است. برای مثال، اگر منبع |
dataSourceColumnReference | ارجاع به ستون منبع داده این گروه بندی بر اساس آن است. |
PivotGroupValueMetadata
فراداده در مورد یک مقدار در یک گروه بندی محوری.
نمایندگی JSON |
---|
{
"value": {
object ( |
فیلدها | |
---|---|
value | مقدار محاسبهشدهای که فراداده با آن مطابقت دارد. (توجه داشته باشید که |
collapsed | اگر داده های مربوط به مقدار جمع شوند درست است. |
PivotGroupSortValueBucket
اطلاعاتی در مورد اینکه کدام مقادیر در یک گروه محوری باید برای مرتب سازی استفاده شود.
نمایندگی JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object ( |
فیلدها | |
---|---|
valuesIndex | افست در لیست |
buckets[] | سطلی را که مقادیر از آن برای مرتبسازی انتخاب میشوند، تعیین میکند. به عنوان مثال، در یک جدول محوری با یک گروه ردیف و دو گروه ستون، گروه ردیف میتواند حداکثر دو مقدار را فهرست کند. مقدار اول مربوط به مقداری در گروه ستون اول است و مقدار دوم مربوط به مقداری در گروه ستون دوم است. اگر هیچ مقداری لیست نشده باشد، این نشان می دهد که ردیف باید بر اساس "کل کل" در گروه های ستون مرتب شود. اگر یک مقدار فهرست شده باشد، این با استفاده از "Total" آن سطل مطابقت دارد. |
PivotGroupRule
یک تنظیم اختیاری در یک PivotGroup
که به جای شکستن هر مقدار جداگانه، سطل هایی را برای مقادیر در ستون داده منبع تعریف می کند. فقط یک PivotGroup
با یک قانون گروه ممکن است برای هر ستون در داده های منبع اضافه شود، اگرچه در هر ستون داده شده می توانید هم PivotGroup
را اضافه کنید که دارای یک قانون است و یک PivotGroup
که ندارد.
نمایندگی JSON |
---|
{ // Union field |
فیلدها | |
---|---|
rule میدان اتحادیه قانونی که باید در PivotGroup اعمال شود. rule فقط می تواند یکی از موارد زیر باشد: | |
manualRule | یک |
histogramRule | |
dateTimeRule | A |
ManualRule
به شما امکان میدهد مقادیر موجود در یک ستون داده منبع را بهصورت دستی در سطلهایی با نامهای دلخواه سازماندهی کنید. به عنوان مثال، جدول محوری که جمعیت را بر اساس ایالت جمع می کند:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
را می توان با ارائه لیستی از گروه ها (به عنوان مثال groupName = 'Central', items = ['AL', 'AR', 'IA', ...]) به یک جدول محوری تبدیل کرد که جمعیت را بر اساس منطقه زمانی جمع می کند. یک قانون گروه دستی توجه داشته باشید که با افزودن یک ستون منطقه زمانی به دادههای منبع و تنظیم جدول محوری، میتوان به اثر مشابهی دست یافت.
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
نمایندگی JSON |
---|
{
"groups": [
{
object ( |
فیلدها | |
---|---|
groups[] | فهرستی از نام گروه ها و موارد مربوطه از داده های منبع که به نام هر گروه نگاشت می شوند. |
ManualRuleGroup
یک نام گروه و یک لیست از موارد از داده های منبع که باید در گروه با این نام قرار گیرند.
نمایندگی JSON |
---|
{ "groupName": { object ( |
فیلدها | |
---|---|
groupName | نام گروه، که باید یک رشته باشد. هر گروه در یک |
items[] | موارد موجود در داده های منبع که باید در این گروه قرار گیرند. هر آیتم ممکن است رشته، عدد یا بولی باشد. موارد ممکن است حداکثر در یک گروه در یک |
قانون هیستوگرام
به شما امکان می دهد مقادیر عددی را در یک ستون داده منبع در سطل هایی با اندازه ثابت سازماندهی کنید. همه مقادیر از HistogramRule.start
تا HistogramRule.end
در گروه هایی با اندازه HistogramRule.interval
قرار می گیرند. علاوه بر این، تمام مقادیر زیر HistogramRule.start
در یک گروه و تمام مقادیر بالای HistogramRule.end
در گروهی دیگر قرار می گیرند. فقط HistogramRule.interval
مورد نیاز است، اگرچه اگر HistogramRule.start
و HistogramRule.end
هر دو ارائه شده باشند، HistogramRule.start
باید کمتر از HistogramRule.end
باشد. برای مثال، یک جدول محوری که میانگین مقدار خرید را بر اساس سن نشان میدهد که دارای بیش از 50 ردیف است:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
می توان با اعمال یک قانون گروه هیستوگرام با HistogramRule.start
25، HistogramRule.interval
20 و HistogramRule.end
از 65 به یک جدول محوری شبیه به شکل زیر تبدیل شود.
+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25 | $19.34 |
| 25-45 | $31.43 |
| 45-65 | $35.87 |
| > 65 | $27.55 |
+-------------+-------------------+
| Grand Total | $29.12 |
+-------------+-------------------+
نمایندگی JSON |
---|
{ "interval": number, "start": number, "end": number } |
فیلدها | |
---|---|
interval | اندازه سطل هایی که ایجاد می شود. باید مثبت باشه |
start | حداقل مقداری که در آن اقلام در سطل هایی با اندازه ثابت قرار می گیرند. مقادیر زیر شروع در یک سطل واحد جمع می شوند. این فیلد اختیاری است. |
end | حداکثر مقداری که در آن اقلام در سطل هایی با اندازه ثابت قرار می گیرند. مقادیر بالای انتهایی در یک سطل واحد جمع می شوند. این فیلد اختیاری است. |
DateTimeRule
به شما امکان میدهد مقادیر تاریخ-زمان را در یک ستون داده منبع در سطلهایی بر اساس بخشهای انتخاب شده از مقادیر تاریخ یا زمان آنها سازماندهی کنید. به عنوان مثال، جدول محوری را در نظر بگیرید که معاملات فروش را بر اساس تاریخ نشان می دهد:
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
اعمال یک قانون گروه تاریخ-زمان با DateTimeRuleType
YEAR_MONTH منجر به جدول محوری زیر می شود.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
نمایندگی JSON |
---|
{
"type": enum ( |
فیلدها | |
---|---|
type | نوع گروه بندی تاریخ-زمان برای اعمال. |
DateTimeRuleType
انواع موجود قوانین گروه بندی تاریخ-زمان. این مستندات فرض میکند که منطقه صفحهگسترده "en-US" است، اگرچه رندر واقعی تاریخها و زمانها از محلی صفحهگسترده برای برخی از انواع قوانین استفاده میکند.
Enums | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED | نوع پیش فرض، استفاده نکنید. |
SECOND | تاریخ گروه بر حسب ثانیه، از 0 تا 59. |
MINUTE | تاریخ های گروه به دقیقه، از 0 تا 59. |
HOUR | با استفاده از یک سیستم 24 ساعته، از 0 تا 23، تاریخ ها را بر اساس ساعت گروه بندی کنید. |
HOUR_MINUTE | با استفاده از یک سیستم 24 ساعته، به عنوان مثال 19:45، تاریخ ها را بر اساس ساعت و دقیقه گروه بندی کنید. |
HOUR_MINUTE_AMPM | با استفاده از یک سیستم 12 ساعته، به عنوان مثال 7:45 عصر، تاریخ ها را بر اساس ساعت و دقیقه گروه بندی کنید. تعیین AM/PM بر اساس منطقه صفحه گسترده ترجمه شده است. |
DAY_OF_WEEK | تاریخ ها را بر اساس روز هفته، به عنوان مثال یکشنبه، گروه بندی کنید. روزهای هفته بر اساس منطقه صفحه گسترده ترجمه خواهند شد. |
DAY_OF_YEAR | تاریخ ها را بر اساس روزهای سال، از 1 تا 366 گروه بندی کنید. توجه داشته باشید که تاریخ های بعد از 29 فوریه در سال های کبیسه در سطل های متفاوتی نسبت به سال های غیر کبیسه قرار می گیرند. |
DAY_OF_MONTH | تاریخ های گروه بر اساس روز ماه، از 1 تا 31. |
DAY_MONTH | تاریخ ها را بر اساس روز و ماه گروه بندی کنید، برای مثال 22 تا نوامبر. ماه بر اساس منطقه صفحه گسترده ترجمه شده است. |
MONTH | تاریخ ها را بر اساس ماه گروه بندی کنید، برای مثال نوامبر. ماه بر اساس منطقه صفحه گسترده ترجمه می شود. |
QUARTER | تاریخ ها را بر اساس سه ماهه گروه بندی کنید، برای مثال Q1 (که نشان دهنده ژانویه-مارس است). |
YEAR | تاریخ های گروه بر اساس سال، به عنوان مثال 2008. |
YEAR_MONTH | تاریخ های گروه بر اساس سال و ماه، به عنوان مثال 2008- نوامبر. ماه بر اساس منطقه صفحه گسترده ترجمه شده است. |
YEAR_QUARTER | تاریخ های گروه بر اساس سال و سه ماهه، به عنوان مثال Q4 2008. |
YEAR_MONTH_DAY | تاریخ ها را بر اساس سال، ماه و روز گروه بندی کنید، به عنوان مثال 22-11-2008. |
PivotGroupLimit
محدودیت تعداد ردیفها یا ستونها در گروه محوری.
نمایندگی JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
فیلدها | |
---|---|
countLimit | حد شمارش |
applyOrder | ترتیب اعمال محدودیت گروه در جدول محوری. محدودیت های گروه محوری از تعداد مرتبه پایین تر به بالاتر اعمال می شود. اعداد سفارشی به اعداد صحیح متوالی از 0 نرمال می شوند. برای درخواست نوشتن، برای سفارشیسازی کامل سفارشهای اعمالشده، تمام محدودیتهای گروه محوری باید این فیلد را با یک شماره منحصربهفرد تنظیم کنند. در غیر این صورت، ترتیب با شاخص در لیست |
معیارهای PivotFilter
معیارهای نمایش/مخفی کردن سطرها در جدول محوری.
نمایندگی JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
فیلدها | |
---|---|
visibleValues[] | ارزش هایی که باید لحاظ شود. مقادیری که در اینجا فهرست نشده اند مستثنی هستند. |
condition | شرطی که برای نمایش مقادیر باید درست باشد. ( مقادیر شرطی که به محدوده ها در نماد A1 اشاره می کنند، نسبت به صفحه جدول محوری ارزیابی می شوند. ارجاعات کاملاً بررسی می شوند، بنابراین جدول محوری پر نمی شوند. برای مثال، مقدار شرط داده های منبع جدول محوری را می توان با نام سرصفحه ستون ارجاع داد. برای مثال، اگر دادههای منبع دارای ستونهایی به نامهای «درآمد» و «هزینه» هستند و شرطی با نوع |
visibleByDefault | اینکه آیا مقادیر به طور پیش فرض قابل مشاهده هستند یا خیر. اگر درست باشد، |
PivotFilterSpec
معیارهای فیلتر جدول محوری مرتبط با افست ستون منبع خاص.
نمایندگی JSON |
---|
{ "filterCriteria": { object ( |
فیلدها | |
---|---|
filterCriteria | معیارهای ستون |
source میدان اتحادیه ستون منبعی که این فیلتر روی آن اعمال می شود. source می تواند تنها یکی از موارد زیر باشد: | |
columnOffsetIndex | آفست ستون مبتنی بر صفر محدوده منبع. |
dataSourceColumnReference | ارجاع به ستون منبع داده. |
PivotValue
تعریف نحوه محاسبه یک مقدار در جدول محوری.
نمایندگی JSON |
---|
{ "summarizeFunction": enum ( |
فیلدها | |
---|---|
summarizeFunction | تابعی برای خلاصه کردن مقدار. اگر |
name | نامی برای استفاده از مقدار |
calculatedDisplayType | اگر مشخص شده باشد، نشان می دهد که مقادیر محوری باید به عنوان نتیجه یک محاسبه با مقدار محوری دیگری نمایش داده شوند. برای مثال، اگر محاسبهشدهDisplayType بهعنوان PERCENT_OF_GRAND_TOTAL مشخص شود، همه مقادیر محوری بهعنوان درصد کل کل نمایش داده میشوند. در ویرایشگر Sheets، در قسمت مقدار یک جدول محوری به آن «نمایش بهعنوان» گفته میشود. |
value فیلد اتحادیه داده هایی که برای مقادیر در جدول محوری استفاده می شود. دقیقاً یک مقدار باید تنظیم شود. value فقط می تواند یکی از موارد زیر باشد: | |
sourceColumnOffset | تغییر ستون محدوده منبع که این مقدار از آن خوانده می شود. به عنوان مثال، اگر منبع |
formula | فرمول سفارشی برای محاسبه مقدار فرمول باید با کاراکتر |
dataSourceColumnReference | ارجاع به ستون منبع داده که این مقدار از آن خوانده می شود. |
PivotValueSummarizeFunction
تابعی برای خلاصه کردن یک مقدار محوری.
Enums | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED | پیش فرض، استفاده نکنید. |
SUM | مربوط به تابع SUM است. |
COUNTA | مربوط به تابع COUNTA است. |
COUNT | مربوط به تابع COUNT است. |
COUNTUNIQUE | مربوط به تابع COUNTUNIQUE است. |
AVERAGE | مربوط به تابع AVERAGE است. |
MAX | مربوط به تابع MAX است. |
MIN | مربوط به تابع MIN است. |
MEDIAN | مربوط به تابع MEDIAN است. |
PRODUCT | مربوط به عملکرد PRODUCT است. |
STDEV | مربوط به تابع STDEV است. |
STDEVP | مربوط به تابع STDEVP است. |
VAR | مربوط به تابع VAR است. |
VARP | مربوط به تابع VARP است. |
CUSTOM | نشان می دهد که فرمول باید همانطور که هست استفاده شود. فقط در صورتی معتبر است که PivotValue.formula تنظیم شده باشد. |
NONE | نشان می دهد که مقدار قبلاً خلاصه شده است و تابع خلاصه سازی به صراحت مشخص نشده است. برای جداول محوری منبع داده Looker که مقدار قبلاً خلاصه شده است استفاده می شود. |
PivotValueCalculatedDisplayType
روش های ممکن که مقادیر محوری ممکن است برای نمایش محاسبه شوند.
Enums | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED | مقدار پیش فرض، استفاده نکنید. |
PERCENT_OF_ROW_TOTAL | مقادیر محوری را به عنوان درصدی از مقادیر کل ردیف نشان می دهد. |
PERCENT_OF_COLUMN_TOTAL | مقادیر محوری را به عنوان درصدی از مقادیر کل ستون نشان می دهد. |
PERCENT_OF_GRAND_TOTAL | مقادیر محوری را به عنوان درصدی از مقادیر کل کل نشان می دهد. |
PivotValueLayout
طرح بندی مقادیر محوری.
Enums | |
---|---|
HORIZONTAL | مقادیر به صورت افقی (به عنوان ستون) قرار می گیرند. |
VERTICAL | مقادیر به صورت عمودی (به عنوان ردیف) قرار می گیرند. |