لوگوی سایت
پشتیبانی
ایجاد و مدیریت دیتاست

انواع ستون و نوع مقدار

در این صفحه با انواع ستون‌ها و مقادیر پشتیبانی شده در داده‌لند آشنا می‌شوید.

در داده‌لند هر ستون دارای دو ویژگی کلیدی است:

  1. نوع ستون: این ویژگی نشان‌دهنده نوع فنی ستون (مانند رشته، عدد، تاریخ و...) است که در همه پایگاه‌های داده وجود دارد.
  2. نوع مقدار: این ویژگی مختص داده‌لند است و محتوای داده را مشخص می‌کند. بر اساس نوع مقدار، سیستم ممکن است تبدیل‌های خاصی را به‌صورت خودکار روی داده‌ها انجام دهد و یا آن‌ها را با فرمت‌های نمایشی بهینه و کاربردی‌تر در شیت‌ها نمایش دهد.
توصیه می‌کنیم نوع مقدار را همواره متناسب با ماهیت داده انتخاب کنید. ویژگی‌های جدیدی در آینده برای انواع مقادیر اضافه خواهد شد که بر اساس این انتخاب عمل خواهند کرد.

دسترسی

از دو طریق با این تنظیمات مواجه خواهید شد:

  • ایجاد دیتاست: برای مشاهده این تنظیمات در مسیر ایجاد دیتاست باید در یکی از پروژه‌ها دسترسی ایجاد دیتاست داشته باشید.
  • مدیریت دیتاست: در بخش مدیریت دیتاست زمانی که قصد ویرایش اسکیما (ویرایش یا افزودن ستون) را دارید، می‌توانید این تنظیمات را مشاهده کنید. برای دسترسی به این بخش باید به دیتاست مدنظر دسترسی مدیریت داشته باشید.
نکات زیر را برای دسترسی به مدیریت نوع ستون و نوع مقدار در نظر بگیرید:
  • در حال حاضر نوع ستون پس از ایجاد ستون قابل تغییر نیست.
  • نوع مقدار در برخی از ستون‌های سیستمی و پیش‌فرض از جداول ماژول قابل تغییر نیست.
  • در حال حاضر امکان تغییر نوع مقدار برای ستون‌هایی با نوع عدد پس ایجاد ستون وجود ندارد.

لیست انواع ستون

جدول زیر لیست انواع ستون‌های پشتیبانی شده در داده‌لند را نمایش می‌دهد:

نام فارسینام انگلیسیتوضیحاتنمونه
رشتهSTRINGبرای ذخیره متن‌های کوتاه و بلند"Hello World"
عددNUMBERبرای ذخیره اعداد صحیح و اعشاری مثبت و منفی100 -12.5
بولینBOOLEANبرای ذخیره مقادیر صفر و یک1 0
تاریخDATEبرای ذخیره تاریخ (بدون زمان)2024-03-20
تاریخ و ساعتDATETIMEبرای ذخیره تاریخ به همراه زمان با دقت میلی‌ثانیه2024-03-20 14:30:00.123
جیسونJSONبرای ذخیره آبجکت و داده‌های نیمه‌ساختاریافته{"id": 1, "name": "Ali"}
آرایهARRAYبرای ذخیره لیستی از مقادیر متنی["tag1", "tag2"]

رشته (STRING)

این نوع ستون برای ذخیره هرگونه داده متنی استفاده می‌شود. هر نوع مقدار انتخابی حداکثر بایت مجاز مخصوص به خود را دارد.


انواع مقدار:

نوع مقدارتوضیحاتفرمت نمایشی خاصعملیات
عادی کوتاهبرای ذخیره سایر مقادیر کاربرد دارد. حداکثر طول رشته مجاز ۳۲ بایت است و می‌تواند کلید اصلی باشد.❌❌
عادی متوسطبرای ذخیره سایر مقادیر کاربرد دارد. حداکثر طول رشته مجاز ۶۴ بایت است و می‌تواند کلید اصلی باشد.❌❌
عادی بلندبرای ذخیره مقادیر بلند کاربرد دارد. حداکثر طول رشته مجاز ۲۵۵ بایت است و نمی‌تواند کلید اصلی باشد.❌❌
شناسه یکتابرای ذخیره هر نوع شناسه یکتا مانند UUID کاربرد دارد. حداکثر طول رشته مجاز ۳۶ بایت است و می‌تواند کلید اصلی باشد.❌❌
آدرس اینترنتیبرای ذخیره مقادیر URL همراه با پروتکل و دامنه کاربرد دارد. حداکثر طول رشته مجاز ۱۰۲۴ بایت است و نمی‌تواند کلید اصلی باشد.✅❌
نام مرورگرنام مرورگر درخواست‌دهنده (مانند chrome) استخراج و ثبت می‌شود. این مقدار خودکار استخراج خواهد شد و نیازی به ارسال مقادیر برای آن ندارید.✅✅ (استخراج)
نسخه مرورگرنسخه مرورگر درخواست‌دهنده استخراج و ثبت می‌شود. این مقدار خودکار استخراج خواهد شد و نیازی به ارسال مقادیر برای آن ندارید.❌✅ (استخراج)
نام سیستم عاملسیستم‌عامل درخواست‌دهنده (مانند android) استخراج و ثبت می‌شود. این مقدار خودکار استخراج خواهد شد و نیازی به ارسال مقادیر برای آن ندارید.✅✅ (استخراج)
نسخه سیستم عاملنسخه سیستم‌عامل درخواست‌دهنده استخراج و ثبت می‌شود. این مقدار خودکار استخراج خواهد شد و نیازی به ارسال مقادیر برای آن ندارید.❌✅ (استخراج)
شماره تلفنبرای ذخیره شماره تلفن ثابت یا همراه کاربرد دارد. حداکثر طول رشته مجاز ۲۰ بایت است و می‌تواند کلید اصلی باشد.✅✅ (اعتبارسنجی و نرمال‌سازی)
ایمیلبرای ذخیره ایمیل کاربرد دارد. حداکثر طول رشته مجاز ۱۲۸ بایت است و نمی‌تواند کلید اصلی باشد.❌✅ (اعتبارسنجی)
واحد پولی (Currency)*برای ذخیره واحد پولی کاربرد دارد و می‌تواند کلید اصلی باشد. باید یکی از کدهای پولی معتبر داده‌لند باشد.❌✅ (اعتبارسنجی)
آدرس آی‌پیبرای ذخیره انواع آی‌پی (IP) کاربرد دارد. حداکثر طول رشته مجاز ۴۵ بایت است و می‌تواند کلید اصلی باشد.❌✅ (اعتبارسنجی)
در محاسبهٔ طول رشته، هر کاراکتر فارسی معادل ۲ بایت در نظر گرفته می‌شود. بنابراین ستونی با سقف ۳۲ بایت حداکثر ۱۶ کاراکتر فارسی و ستونی با سقف ۶۴ بایت حداکثر ۳۲ کاراکتر فارسی را پذیرش می‌کند. هنگام انتخاب نوع مقدار، این محدودیت را در نظر بگیرید.

عدد (NUMBER)

این نوع ستون برای انجام محاسبات ریاضی و ذخیره مقادیر کمی استفاده می‌شود. نوع مقدار باید متناسب با داد‌ه‌ها انتخاب شود.


انواع مقدار:

نوع مقدارتوضیحاتفرمت نمایشی خاصعملیات
اعداد صحیح کوچک / SMALLINTاعداد صحیح (غیراعشاری) مثبت و منفی تا سقف ۵ رقم را پوشش می‌دهد.✅✅ (اعتبارسنجی)
اعداد صحیح متوسط / INTاعداد صحیح (غیراعشاری) مثبت و منفی تا سقف ۱۰ رقم را پوشش می‌دهد.✅✅ (اعتبارسنجی)
اعداد صحیح بزرگ / BIGINTاعداد صحیح (غیراعشاری) مثبت و منفی تا سقف ۱۹ رقم را پوشش می‌دهد. برای پرفورمنس بهتر تنها زمانی که به این تعداد رقم نیاز دارید استفاده شود.✅✅ (اعتبارسنجی)
اعداد اعشاری ۶ رقم / DECIMAL(18,6)اعداد صحیح (تا ۱۲ رقم) و اعشاری (تا ۶ رقم) مثبت و منفی را پوشش می‌دهد. نمی‌تواند کلید اصلی باشد.✅✅ (اعتبارسنجی)
اعداد اعشاری ۱۲ رقم / DECIMAL(18,12)اعداد صحیح (تا ۶ رقم) و اعشاری (تا ۱۲ رقم) مثبت و منفی را پوشش می‌دهد. نمی‌تواند کلید اصلی باشد.✅✅ (اعتبارسنجی)
مبلغ / DECIMAL(18,4)اعداد صحیح (تا ۱۴ رقم) و اعشاری (تا ۴ رقم) مثبت و منفی را برای ثبت مبالغ پوشش می‌دهد. نمی‌تواند کلید اصلی باشد.✅✅ (اعتبارسنجی)
درصد / DECIMAL(5,2)درصد را تا مثبت یا منفی ۹۹۹.۹۹ ثبت می‌کند. نمی‌تواند کلید اصلی باشد.✅✅ (اعتبارسنجی)
امتیاز / DECIMAL(5,2)امتیاز یا نمره را تا مثبت یا منفی ۹۹۹.۹۹ ثبت می‌کند. نمی‌تواند کلید اصلی باشد.✅✅ (اعتبارسنجی)
موقعیت جغرافیایی / DOUBLEطول یا عرض جغرافیایی (lat/long) را با دقت بالا ذخیره می‌کند. نمی‌تواند کلید اصلی باشد.❌✅ (اعتبارسنجی)
مدت زمان / BIGINTفقط اعداد صحیح مثبت (تا ۱۹ رقم) مجاز هستند. مقادیر باید نشانگر مدت زمان به میلی‌ثانیه باشند.✅✅ (اعتبارسنجی)

مثال‌های معتبر و غیرمعتبر:

نوع مقداررنج مجاز عددیمقادیر مجازمقادیر غیرمجاز
اعداد صحیح کوچک / SMALLINT[-32768, 32767]0
12345
-12345		32768
123.5
1,000
abc
اعداد صحیح متوسط / INT[-2147483648, 2147483647]0
12345
-12345		2147483648
123.5
1,000
abc
اعداد صحیح بزرگ / BIGINT[-9223372036854775808, 9223372036854775807]12345
-12345
0		9223372036854775808
123.5
1,000
abc
اعداد اعشاری ۶ رقم / DECIMAL(18,6)حداکثر ۱۲ رقم صحیح + ۶ رقم اعشار123456789012.123456
0.000001
-12345
12345		1234567890123.1
1.1234567
1,000
abc
اعداد اعشاری ۱۲ رقم / DECIMAL(18,12)حداکثر ۶ رقم صحیح + ۱۲ رقم اعشار123456.123456789012
0.000000000001
-12345
12345		1234567.1
1.1234567890123
1,000
abc
مبلغ / DECIMAL(18,4)حداکثر ۱۴ رقم صحیح + ۴ رقم اعشار12345678901234.1234
0.0001
-12345
12345		123456789012345.1
100.12345
1,000
abc
درصد / DECIMAL(5,2)[-999.99, 999.99]0
100
123.5
-123		1000
99.999
10%
1,000
abc
امتیاز / DECIMAL(5,2)[-999.99, 999.99]0
100
123.5
-123		1000
99.999
1,000
abc
موقعیت جغرافیایی / DOUBLE---12.345678
-12.345678		1,000
abc
مدت زمان / BIGINT[0, 9223372036854775807]0
12345		-123
123.5
1,000
abc

بولین (BOOLEAN)

برای ذخیره مقادیر صفر و یک استفاده می‌شود.


انواع مقدار:

نوع مقدارتوضیحاتفرمت نمایشی خاصعملیات
عادیذخیره مقدار بولین استاندارد✅✅ (اعتبارسنجی)
تریگر عملیات حذفردیف‌هایی که مقدار برابر با تریگر انتخابی دارند در بازه‌های ۲۴ ساعته (نیمه شب) حذف خواهند شد. یکی از کارکردهای این گزینه حذف داده‌های دیباگ است.✅✅ (اعتبارسنجی و حذف)

مثال‌های معتبر و غیرمعتبر:

مقادیر مجازمقادیر غیرمجاز
0
1
true
false		TRUE
FALSE
True
False
مقادیر true و false طی فرآیند لود به صورت خودکار تبدیل به 1 و 0 می‌شوند.

تاریخ (DATE)

برای ذخیره تاریخ تقویمی استفاده می‌شود. در داده‌لند، تمامی تاریخ‌ها با فرمت میلادی ذخیره می‌شوند.

اگر نوع مقدار را بر روی عادی تنظیم کرده‌اید، اطمینان حاصل کنید که داده‌ها را با فرمت استاندارد (میلادی) ارسال می‌کنید. اگر تاریخ را در پایگاه داده خود شمسی ذخیره کرده‌اید، می‌توانید نوع مقدار را بر روی تبدیل از شمسی تنظیم کنید تا داده‌لند در حین درج آن را به فرمت میلادی تبدیل و ذخیره نماید.


انواع مقدار:

نوع مقدارتوضیحاتفرمت نمایشی خاصعملیات
عادیذخیره تاریخ استاندارد✅✅ (اعتبارسنجی)
تبدیل از شمسیتبدیل خودکار از شمسی و ذخیره به میلادی✅✅ (اعتبارسنجی و تبدیل)

فرمت مجاز:

فرمت صحیحمثال
YYYY-MM-DD2024-01-01

تاریخ و ساعت (DATETIME)

برای ذخیره دقیق زمان (تاریخ + ساعت) استفاده می‌شود. در داده‌لند، این داده‌ها با فرمت میلادی و منطقه زمانی تهران (Asia/Tehran) ذخیره می‌شوند و سیستم تنها تاریخ‌های برابر یا بعد از 01-01-1970 را معتبر تشخیص می‌دهد.

اگر نوع مقدار را بر روی عادی تنظیم کرده‌اید، لازم است داده‌ها را دقیقاً مطابق با فرمت استاندارد (میلادی + Asia/Tehran) ارسال کنید؛ در این حالت هیچ‌گونه تبدیلی روی داده‌ها انجام نمی‌شود.
در صورتی که امکان ارسال داده با این فرمت را ندارید، می‌توانید نوع مقدار را بر روی تبدیل از شمسی یا تبدیل از UTC تنظیم کنید تا داده‌لند در حین درج، تبدیل لازم را انجام داده و مقدار را به‌صورت استاندارد ذخیره نماید.


انواع مقدار:

نوع مقدارتوضیحاتفرمت نمایشی خاصعملیات
عادیذخیره تاریخ و ساعت استاندارد (میلادی + تهران)✅✅ (اعتبارسنجی)
تبدیل از شمسیتبدیل خودکار تاریخ شمسی به میلادی (عدم تبدیل ساعت)✅✅ (اعتبارسنجی و تبدیل)
تبدیل از UTCتبدیل منطقه زمانی از UTC به تهران (تبدیل تاریخ در صورت نیاز)✅✅ (اعتبارسنجی و تبدیل)

فرمت‌های مجاز:

فرمت صحیحمثال
YYYY-MM-DD2024-01-01
YYYY-MM-DD HH:mm:ss.ffffff2024-01-01 12:00:00
2024-01-01 12:00:00.123456
YYYY-MM-DDTHH:mm:ss.SSS2024-01-01T12:00:00
2024-01-01T12:00:00.123
YYYY-MM-DDTHH:mm:ss.SSSZ2024-01-01T12:00:00Z
2024-01-01T12:00:00.123Z

جیسون (JSON)

برای ذخیره اشیاء (Objects) استفاده می‌شود. داده‌لند ساختاری JSON-Friendly دارد و ابزارهای رابط کاربری آن امکان کار آسان با داده‌های جیسون را فراهم می‌کنند. با این حال، همان‌طور که در بخش الگوهای پیشنهادی ذکر شده، توصیه می‌شود از ساختارهای مسطح (Flat JSON) استفاده کنید و از ارسال آبجکت‌های تودرتو (Nested Objects) خودداری نمایید تا بهترین عملکرد را در تحلیل‌ها تجربه کنید.


فرمت‌های مجاز:

مقدار ارسالی برای ستون‌های جیسون باید همواره یک شیء (Object) باشد و ارسال آرایه (Array) به عنوان بالاترین سطح (ریشه) مجاز نیست. با این حال استفاده از آرایه‌ها به عنوان مقدار در داخل کلیدهای جیسون معتبر است.

مقادیر مجازمقادیر غیرمجاز
{"id": 1, "name": "Ali"}
{"roles": ["admin", "user"]}		[1, 2, 3]
[{"id": 1}, {"id": 2}]

انواع مقدار:

نوع مقدارتوضیحاتفرمت نمایشی خاصعملیات
عادیذخیره داده‌های جیسون استاندارد❌✅ (اعتبارسنجی)

آرایه (ARRAY)

برای ذخیره مجموعه‌ای مرتب از مقادیر در قالب یک لیست استفاده می‌شود. در حال حاضر ستون‌های نوع آرایه از مقادیر متنی (آرایه‌ای از رشته‌ها) پشتیبانی می‌کنند.


فرمت‌های مجاز:

مقدار ارسالی برای ستون‌های آرایه باید به صورت یک آرایه استاندارد جیسون شامل رشته‌های متنی باشد:

مقادیر مجازمقادیر غیرمجاز
["tag1", "tag2"]
["admin"]
[]		[1, 2, 3]
[{"id": 1}]
{"tags": ["vue"]}
"vue, react"

انواع مقدار:

نوع مقدارتوضیحاتفرمت نمایشی خاصعملیات
رشتهذخیره آرایه‌ای از رشته‌های متنی✅✅ (اعتبارسنجی)