Metabase

تنظیمات ادمین ابردادهٔ جدول

Admin settings > Table metadata

تنظیمات ابردادهٔ جدول

متابیس به شما امکان می‌دهد ابرداده را برای جداول و ستون‌هایتان اضافه و ویرایش کنید.

تنظیمات ابردادهٔ جدول فقط بر نحوهٔ نمایش داده توسط متابیس تأثیر می‌گذارد. هیچ یک از تنظیمات داده را در پایگاه داده شما تغییر نمی‌دهد.

ادمین‌ها می‌توانند دسترسی به این تنظیمات ابرداده را به گروه‌های دیگر اعطا کنند. به مجوزهای ابردادهٔ جدول مراجعه کنید.

تنظیمات جدول

Admin settings > Table metadata > Database > Table

می‌توانید برای جداول جستجو کنید، یا از ناوبری درختی برای پیدا کردن هر یک از پایگاه‌داده‌های متصل و جداول آن‌ها استفاده کنید.

نام نمایشی و توضیحات جدول

برای ویرایش نام نمایشی یا توضیحات یک جدول در تب ابردادهٔ جدول، روی جعبه‌ای که حاوی نام یا توضیحات جدول فعلی است کلیک کنید و آن را ویرایش کنید. تغییرات به‌طور خودکار ذخیره می‌شوند وقتی از جعبه خارج می‌شوید.

توضیحات در مرجع داده متابیس و tooltipها هنگام مشاهدهٔ جدول نمایش داده می‌شوند. توضیحات به افراد کمک می‌کنند جدول درست را برای مورد استفاده‌شان پیدا کنند.

گزینه‌های همگام‌سازی جدول

اقداماتی که می‌توانید برای به‌روزرسانی schema یا مقادیر فیلد انجام دهید. برای اطلاعات بیشتر، به همگام‌سازی‌ها و اسکن‌ها مراجعه کنید.

همگام‌سازی schema جدول

اگر تغییراتی در این جدول در پایگاه داده زیربنایی ایجاد کرده‌اید که هنوز در متابیس نمایش داده نمی‌شوند، همگام‌سازی مجدد schema جدول می‌تواند آن را برطرف کند.

برای به‌روزرسانی مقادیر در منوهای dropdown فیلتر، مقادیر کش‌شده را رفرش یا بازنشانی کنید.

اسکن مقادیر فیلد

متابیس از این مقادیر برای پر کردن فیلترهای dropdown استفاده می‌کند. همچنین می‌توانید مقادیر را برای یک فیلد خاص اسکن کنید.

دور انداختن مقادیر فیلد کش‌شده

مقادیر کش‌شده را پاک می‌کند. متابیس مقادیر جدید را برای نمایش در ویجت‌های فیلتر شما می‌کشد.

مرتب‌سازی جدول

می‌توانید فیلدها را در یک جدول به روش‌های مختلف مرتب کنید:

  • به‌طور خودکار (متابیس برای شما تصمیم می‌گیرد)
  • بر اساس نحوهٔ ظاهر شدن در پایگاه داده
  • به‌صورت الفبایی
  • ترتیب سفارشی (فقط drag and drop کنید تا مرتب‌سازی مجدد کنید، سپس "Done" را کلیک کنید)

قابلیت مشاهدهٔ جدول

می‌توانید قابلیت مشاهدهٔ یک جدول را با کلیک روی آیکون eye کنار نام جدول در درخت ناوبری نوار کناری چپ در تب Table metadata toggle کنید.

جداول مخفی در query builder یا مرجع داده نمایش داده نمی‌شوند. اما این یک ویژگی مجوز نیست: جداول مخفی همچنان می‌توانند در سؤال‌های SQL استفاده شوند اگر کسی نام جدول را بداند. به‌عنوان مثال، SELECT * FROM table_name از ویرایشگر SQL نتایج را برمی‌گرداند. برای جلوگیری از نوشتن کوئری‌ها علیه جداول خاص توسط افراد، به مجوزهای داده مراجعه کنید.

برای مخفی کردن همهٔ جداول در یک پایگاه داده (مثلاً اگر به یک پایگاه داده جدید migrate کرده‌اید)، روی آیکون eye کنار نام پایگاه داده در نوار کناری کلیک کنید.

تنظیمات فیلد

Admin settings > Table Metadata > Database > Table > Field

فیلدها همچنین به‌عنوان ستون‌ها شناخته می‌شوند (به تفاوت بین فیلدها و ستون‌ها مراجعه کنید).

نام و توضیحات فیلد

برای تغییر نام نمایشی سراسری یک ستون در متابیس، روی نام ستون کلیک کنید. به‌عنوان مثال، می‌توانید "auth.user" را به‌عنوان "User" نمایش دهید تا ستون خوانا تر شود. افراد همچنین می‌توانند از مدل‌ها برای دادن یک نام نمایشی به ستون‌ها استفاده کنند که محلی به مدل است.

برای اضافه کردن یک توضیحات، روی جعبه زیر نام ستون کلیک کنید. توضیحات در مرجع داده نمایش داده می‌شوند تا به افراد کمک کنند مقادیر ستون را تفسیر کنند. باید در نظر بگیرید که یک توضیحات اضافه کنید اگر ستون شما حاوی موارد زیر است:

  • مخفف‌ها یا کدها
  • صفرها، nullها، یا مقادیر خالی
  • مقادیر placeholder، مثل 9999-99-99

پیش‌نمایش فیلد

پیش‌نمایش فیلتر کردن فیلد

روی دکمهٔ preview کلیک کنید تا دادهٔ نمونه از آن فیلد را ببینید.

  • Table preview
  • Detail
  • Filtering

اسکن مقادیر برای یک فیلد خاص

Admin settings > Table Metadata > Database > Table > Field

برای اسکن یا دور انداختن مقادیر فیلد برای یک فیلد خاص، روی دکمهٔ Field values کلیک کنید. متابیس از این مقادیر برای پر کردن منوهای dropdown در ویجت‌های فیلتر استفاده می‌کند. (مقادیر از پایگاه داده شما حذف نمی‌شوند.)

دادهٔ فیلد

Admin settings > Table Metadata > Database > Table > Field

نام فیلد

این نام فیلد در خود پایگاه داده است. نمی‌توانید آن را در متابیس تغییر دهید.

نوع داده

این نوع دادهٔ فیلد در پایگاه داده است. نمی‌توانید نوع داده را در متابیس تغییر دهید، اما می‌توانید انواع دادهٔ خاص را به نوع دادهٔ دیگر cast کنید.

Cast به یک نوع دادهٔ خاص

اگر می‌خواهید متابیس یک ستون متن یا عدد را به‌عنوان یک ستون datetime در نظر بگیرد، می‌توانید آن را به آن نوع cast کنید. Cast کردن انواع داده روی انواع دادهٔ اصلی در پایگاه داده شما تأثیر نمی‌گذارد.

به‌عنوان مثال، فرض کنید یک ستون "Created At" با یک نوع داده رشته در پایگاه داده خود دارید. اگر می‌خواهید:

  • فیلترهای تاریخ نسبی ایجاد کنید، مثل "Created At = Last week".
  • از "Created At" با فرمول‌هایی مثل datetimeAdd استفاده کنید.

می‌توانید آن رشته را به یک نوع Date cast کنید.

گزینه‌های Cast شامل موارد زیر هستند:

گزینه‌های cast متن به datetime:

  • ISO8601->Date
  • ISO8601->Datetime
  • ISO8601->Time

گزینه‌های cast عددی به datetime:

  • UNIXMicroSeconds->DateTime
  • UNIXMilliSeconds->DateTime
  • UNIXNanoSeconds->DateTime
  • UNIXSeconds->DateTime

گزینه‌های cast متن به عددی:

  • String->Integer
  • String->Float

گزینه‌های دیگر:

  • Float->Integer
  • Datetime->Date

اگر متابیس گزینهٔ cast موردنیاز شما را پشتیبانی نمی‌کند، می‌توانید یک سؤال SQL ایجاد کنید که داده را cast می‌کند و آن را به‌عنوان یک مدل ذخیره کنید، یا یک view مستقیماً در پایگاه داده خود ایجاد کنید.

ابردادهٔ فیلد

Admin settings > Table Metadata > Database > Table > Field

نوع معنایی

می‌توانید نوع معنایی را تغییر دهید تا بافت بیشتری به افراد بدهید و عملکرد اضافی را فعال کنید، مثل نمایش متن به‌صورت تصویر (اگر متن یک URL تصویر است. مثال دیگر: می‌توانید یک Integer را به‌عنوان "Score" تنظیم کنید تا افراد ایدهٔ بهتری از آنچه آن اعداد نشان می‌دهند داشته باشند.

انواع معنایی که می‌توانید از بین آن‌ها انتخاب کنید بستگی به نوع داده دارد. اگر هیچ یک از گزینه‌ها مقادیر در ستون را توصیف نمی‌کند، می‌توانید این تنظیم را به "No semantic type" تنظیم کنید.

به انواع معنایی مراجعه کنید.

رفتار فیلد

Admin settings > Table Metadata > Database > Table > Field

قابلیت مشاهدهٔ فیلد

  • Everywhere: به‌طور پیش‌فرض، کاربران می‌توانند همهٔ ستون‌ها را در یک جدول ببینند.
  • Only in detail views: نمای جزئیات نمای است که وقتی یک ردیف واحد را در یک جدول expand می‌کنید می‌بینید. این متن طولانی را از نتایج سؤال مخفی می‌کند. این تنظیم به‌طور پیش‌فرض اعمال می‌شود اگر مقادیر یک ستون طول متوسط بیش از 50 کاراکتر داشته باشند. به‌عنوان مثال، می‌توانید از این تنظیم روی یک ستون مثل "Customer Comments" استفاده کنید اگر قبلاً یک ستون برای "Customer Rating" دارید.
  • Do not include: ستون‌ها در query builder یا مرجع داده نمایش داده نمی‌شوند. می‌توانید این گزینه را روی ستون‌های حساس (مثل PII) یا ستون‌های نامرتبط تنظیم کنید. اما این گزینهٔ قابلیت مشاهده یک گزینهٔ سادهٔ omit/hide است؛ این یک ویژگی مجوز نیست. این ستون‌ها همچنان برای افراد با مجوزهای کوئری native قابل دسترسی هستند؛ می‌توانند SELECT hidden_column FROM table یا SELECT * FROM table را در ویرایشگر SQL بنویسند و قادر به مشاهدهٔ این فیلدها و مقادیرشان خواهند بود.

برای محدود کردن داده‌ای که افراد می‌توانند مشاهده و کوئری کنند، به مجوزهای داده مراجعه کنید.

فیلتر کردن

تنظیم Filtering ویجت فیلتر پیش‌فرض یک ستون را تغییر می‌دهد. گزینه‌ها شامل موارد زیر هستند:

  • Search box: یک جعبه جستجو نمایش دهید و autocompletion برای مقادیر در آن ستون که با عبارت(های) جستجو تطبیق دارند پیشنهاد دهید.
  • A list of all values: یک جعبه جستجو نمایش دهید، و همچنین یک منوی dropdown با چک‌باکس‌ها برای مقادیر. با این حال، اگر تعداد مقادیر منحصر به فرد از 1000 تجاوز کند، متابیس در عوض یک جعبه جستجو نمایش می‌دهد. به تغییر یک فیلتر جعبه جستجو به یک فیلتر dropdown مراجعه کنید.
  • Plain input box: یک جعبه جستجو نمایش دهید، اما autocompletion پیشنهاد ندهید.

تنظیمات اینجا همچنین روی فیلترهای داشبورد تأثیر می‌گذارد. به‌عنوان مثال، اگر این را به plain input box تنظیم کنید، نمی‌توانید یک فیلتر داشبورد که یک منوی dropdown دارد تنظیم کنید. به لیست dropdown مراجعه کنید.

تغییر یک فیلتر جعبه جستجو به یک فیلتر dropdown

ویجت فیلتر dropdown می‌تواند حساس باشد، چون متابیس نیاز دارد یک اسکن اجرا کند تا لیست مقادیر برای منوی dropdown را دریافت کند. اگر مشکل دارید:

  1. نوع معنایی را به "Category" تنظیم کنید.
  2. Filtering را به "A list of all values" تنظیم کنید.

وقتی یک فیلتر پیش‌فرض را به یک فیلتر dropdown تغییر می‌دهید، یک کوئری پایگاه داده را راه‌اندازی می‌کنید که اولین 1000 مقدار منحصر به فرد (مرتب‌شده صعودی) را برای آن ستون دریافت می‌کند. متابیس اولین 100kB متن را برای نمایش در منوی dropdown کش می‌کند.

اگر ستون‌هایی با بیش از 1000 مقدار منحصر به فرد دارید، یا ستون‌هایی با دادهٔ متنی سنگین، توصیه می‌کنیم Filtering را به "Search box" تنظیم کنید.

نمایش مقادیر

می‌توانید ستون دیگری متصل شده توسط یک رابطهٔ foreign key را نگاشت کنید، مثل نگاشت یک ستون Product_ID برای نمایش نام محصول به جای آن.

نگاشت مقادیر به foreign keyها

می‌توانید ستون دیگری متصل شده توسط یک رابطهٔ foreign key را نگاشت کنید، مثل نگاشت یک ستون Product_ID برای نمایش نام محصول به جای آن.

نگاشت اعداد به مقادیر سفارشی

فرض کنید یک ستون با مقادیر 1، 2، و 3 دارید. می‌توانید به جای آن "low"، "medium"، و "high" را نمایش دهید.

برای اینکه این گزینه در دسترس باشد، باید تنظیمات filtering را به "A list of all values" تنظیم کنید.

"Custom mapping" را از منوی dropdown انتخاب کنید. برای هر مقدار در ستون، یک مقدار نمایشی زیر Mapped values وارد کنید.

قالب‌بندی فیلد

Admin settings > Table Metadata > Database > Table > Field

به قالب‌بندی فیلد مراجعه کنید.

باز کردن JSON

به کار با JSON مراجعه کنید.

مطالعهٔ بیشتر