پست‌ها

lnav ابزاری بسیار کاربردی برای پیمایش لاگ ها در لینوکس و البته مک

تصویر
خب گرمی هوا و تعطیلی فرصتی شد برای نوشتن درباره lnav   طبق تعریف رسمی lanv خودش رو یک نمایش دهنده لاگ فایل که UI اون بر پایه ncurses(رابط کاربری مبتنی بر متن مثل norton commander ) هست میدونه و اما قابلیت ها ادغام و نمایش چندین لاگ فایل در یک پنجره خیلی پیش میاد برای ریشه یابی یک مشکل مجبور باشیم چندین لاگ رو همزمان بررسی کنیم.وقتی چندین فایل رو با هم باز میکنیم براساس timestamp خطوط لاگ رو نمایش میده و به کمک رنگ های متفاوت هر خط رو متمایز میکنه lnav /var/log/messages /var/log/secure تشخیص خودکار فرمت لاگ به صورت داخلی و پیش فرض lanv از لیست بلند بالایی از فرمت ها پشتیبانی میکنه مثلا اکثر وب سرور ها مثل nginx اگرهم فرمت مدنظر شما داخل این لیست نیست امکان تعریف فرمت شخصی رو هم دارید. فیلترکردن لاگ های حجیم قبل از بازکردن معمولا پیش میاد که با یک فایل چند گیگ ی کارداریم و فقط میخواهیم مثلا سطح  WARN ها رو ببینیم . در مثال زیر اگر دقت کنید خروجی شامل کلی لاگ DEBUG هست ولی با کمک فیلتر رسیدیم به چندین خط و البته میتونیم چندین نوع فیلتر دیگه هم داشته باشیم مثلا regex و ... م...

ساختن ایمیج های داکری به کمک BuildKit - بخش دوم

تصویر
 خب با یک فاصله طولانی از بخش اول میرسیم به بخش دوم ساختن ایمیج های داکری به کمک BuildKit در این قسمت قراره درباره امنیت و در واقع امن کردن داکرفایل یا ایمج هامون صحبت کنیم.وقتی که نیاز داریم مثلا به یک مخزن خصوصی وصل بشیم یا یک فایل رو از یک سایت خاص💪 مثلا sonaops.ir دانلود کنیم یا ... و مجبوریم یک سری اطلاعات شخصی (نام کاربری رمز عبور و...) رو وارد کنیم در صورت رعایت نکردن یکسری اصول امنیتی ایمیج ما مستعد خرابکاری میشه و...  تا قبل از BuildKit یک روش استفاده از ARG داخل داکر فایل و مقداردهی اون هنگام build به کمک build-arg بود (و هست) مشکل این روش اینه که از طریق خواندن تاریخچه ساخت یک ایمیج این اطلاعات درز میکنه و البته از اون بدتر اگه این اطلاعات رو به نوعی داخل ایمیج ذخیره کرده باشید به راحتی قابل دسترسی هست (حتی اگه تو یک مرحله اونو پاک کرده باشید) سرچ زیر تو گوگل احتمالا نتیجه های جالبی رو برگردونه inurl:Dockerfile site:github.com intext:"ARG password" OR intext:"ARG secret" OR intext:"ARG pass" و در ادامه در صورت دستیابی به ایمیج مربوطه docker h...

ساختن ایمیج های داکری به کمک BuildKit - بخش اول

تصویر
خب چند سالی هست که داکر راه خوبان رو داره میره و با تعریف پروژه موبی قدم بزرگی تو پشرفت کانتینر سازی (که البته به اشتباه معمولا میگیم داکر سازی و چه اشتباه خوبی ) برداشته.     یکی از زیر پروژه های موبی که اتفاقا بحث اصلی این پست و پست های آتی هست BuildKit نام داره که در واقع ابزاری برای ساخت ایمیج هست که در ابتدا به صورت مجزا قابل استفاده بود(و البته هنوزم هست) و از داکر ورژن 18.09 به صورت داخلی به داکر اضافه شده.   برای استفاده از این بیلدر یا میتونیم متغییر محیطی بنام DOCKER_BUILDKIT رو مقدار دهی کنیم و یا daemon.json رو ویرایش کنیم  export DOCKER_BUILDKIT=1 OR  vi /etc/docker/daemon.json   { "features" : { "buildkit" : true } }  systemctl daemon-reload systemctl restart docker       بعد از تغییر بیلدر پیش فرض داکر خروجی بیلدر هنگام ساخت ایمیج به شکل زیر میشه   نکته : من برای راحتی برای دستور docker دگرنام( alias ) dcr رو انتخاب کردم. در این پست و پست های آتی به برسی قابلیت های مهم BuildKit میپردازیم   پردازش موازی شا...

برسی استاندارد های Branching Model در گیت

تصویر
Git flow   به طور خلاصه  در این استاندارد قابلیت های جدید تحت شاخه های feature در شاخه develop ادغام میشوند.  در زمان رسیدن به زمان انتشار نسخه (چه از بعد تعداد قابلیت جدید یا زمان ) شاخه release ی از شاخه develop شده و اماده تست uat میشود.  شاخه master همیشه شامل نسخه لایو میباشد.  درصورت وجود باگ در نسخه لایو شاخه hotfix ی از master ساخته شده و در نهایت در شاخه master و develop ادغام میشود.      مزایا     اطمینان از تمیز بودن هر شاخه در طول عمر هر پروژه به واسطه تفکیک زیاد شاخه ها از هم نام گذاری قابل فهم شاخه ها پشتیبانی قوی در ابزارهای git  مناسب برای زمانی که میخواهیم چندین ورژن از محصول در محیط لایو یا عملیاتی داشته باشیم   معایب   تاریخچه کامیت های گیت خوانا نمیباشد جداسازی شاخه master و develop بنوعی اضافه تلقی میشود و باعث سخت شدن پروسه ها ci/cd میشود برای داشتن تنها یک نسخه در محیط لایو یا عملیات توصیه نمیشود   Github flow    ساده ترین استاندارد میباشد و به طور خلاصه در این استاندارد قابلیت ه...

یک اسفند دو صفر شروعی دوباره

خب مثل یک چشم بهم زدن ۱۰ سال گذشت ۱۰ فروردین سال ۱۳۹۱ آخرین پست من در این وبلاگ که از SQL server 2012 نوشتم...  زندگی شغلی من هم تو این مدت دستخوش تغییر شد و از دنیای مایکروسافت به دنیای لینوکس ورود کردم از برنامه نویسی c# و سروکله زدن با SQL server تا کلی تجربه و چالش جدید با لینوکس و اوراکل و رسیدن به DevOps.  از سال ۸۷ که زندگی شغلی من تو حوزه IT شروع شد (بعنوان پشتیبان سیستم) همیشه با کارهای تکراری و به اصطلاح گل :) مشکل داشتم و سعی میکردم تا حد ممکن تسک های که سمت من میومد رو خودکار کنم با ابزارهای مثل autoit کار میکردم اسکریپت می‌نوشتم و...  من عاشق کامپیوتر و طبعا کارهام بودم ولی DevOps یک خون تازه ی تو زندگی شغلی من به جریآن انداخت و به نوعی نیمه گمشده من بود. تصمیم گرفتم حال خوبم مخصوصا تو چند سال اخیر رو که به واسطه DevOps بوده با نوشتن بهتر کنم و البته تجربیات م رو با شما به اشتراک بگذارم و هم یاد بدم و هم یاد بگیرم. برای ادامه تصمیم گرفتم اسم وبلاگ رو عوض کنم به SonaOps و اما SonaOps یعنی چه ؟ تکلیف قسمت دوم که مشخصه اسم وبلاگ منم میشه یکی از چند ده نامی که...

ويژگيهاي جديد SQL Server 2012

تصویر
مدتي از انتشار نسخه 2012 ه SQL Server با كد نام Denali ميگذره در اين پست قصد دارم چنديدن ويژگي جديد اين نسخه رو معرفي كنم.ضمنا دريافت اين نسخه و تبديل اون به نسخه نهايي رو از اين پست ميتونيد پيگيري كنيد. AlwaysOn : يكي از مهمترين ويژگيها در SQL Server 2012 در بحث High Availability يا در دسترس بودن هست و در واقع تكميل كننده Database Mirroring در نسخه هاي قبلي ميباشد.در Mirroring ما به صورت تك تك ديتابيس هامون رو ميرور ميكنيم ولي در AlwaysOn اينكار به صورت گروهي انجام ميشه يعني چندين ديتابيس و همچنيا ميتونيم دو روش همزمان (Synchronous) و غير همزمان (Asynchronous) رو با هم تركيب كنيم.بر خلاف ميرورينگ ديتابيس ما به صورت فقط خواندني قابل كوئري گرفتنه و حتي بكاپ گرفتن. نكته:در نسخه هاي قبلي با گرفتن Snapshot از ديتابيس Mirror ميتوان به صورت فقط خواندني از ديتابيس استفاده كرد و … پشتيباني از Windows Server Core : يادمه دوره كارداني استاد شبكه اي داشتيم كه لينوكس رو بهمون به صورت Command ي درس ميداد كلي از دستش شاكي بوديم كه چرا GUI نه ... نسخه 2012 ي SQL Server قابل نصب ر...

جلوگیری از حملات دستکاری آدرس در ASP.NET MVC‌

یکی از ویژگی های ASP.NET MVC نحوه آدرس دهی صفحات و منابع یا همون URL هست که تر و تمیزه و از سوی کاربر قابل فهمه یا به عبارتی SEO Friendly URLs ه.مثلا اگه شما Controller ی بنام Profile داشته باشید که یکی از Action Method های اون Index باشه موقع کار با این Controller آدرس های ارسالی به صورت زیر میشن. www.dotnetdev.info/Profile/2 همه چی آرومه! تا اینکه یه کاربر کنجکاو اون 2 ی آخر URl رو میکنه 3 و… اینجاس که وب سایت شما در مقابل «حمله دستکاری آدرس» یا URL Manipulation Attack یا Parameter Manipulation ضعف داره. و اماچه باید کرد؟ برای جلوگیری از این حمله روش های مختلفی موجود که بعضیاش شکننده و آماتور و بعضیاش حرفه ای ن و البته راه حل نهایی. همونطور که گفتم روش های متفاوتی موجوده که بر میگرده به سناریوی ما که مهمترینش وجود رابطه بین درخواست ارسالی از سمت کاربر و هویت اون کاربره مثلا تو مثال بالا حتما رابطه یک به یک بین پروفایل و کاربر موجوده و یا مثلا یک سیستم اتوماسیون اداری رو در نظر بگیرید بین درخواست های ایجاد شده در سیستم و کاربر رابطه موجوده.خب حالا این رابطه ها کجا ...

ساختن متدهاي كمكي Razor در ASP.NET MVC

تصویر
در نسخه 3 ي  ASP.NET MVC موتور نمايش(view-engine) جديدي بنام Razor اضافه شده ميزان كد نويسي View ها رو كم كرده. يكي از قابليت هاي جالب اون ساختن متدهاي كمكي به صورت اعلانيه(Declarative) كه اين امكان رو ميده در همون فايل View مون بتونيم متدهاي كمكي بسازيم كه ازش در سرتاسر اون View استفاده كنيم. براي مثال فرض كنيد جدولي داريم كه ستوني بنام قيمت(Price) داره حالا ميخواهيم اگه اون ستون كمتر از يك عددي بود اون ستون قرمز بشه و… براي نوشتن اين مثال از سري آموزشي MVC Music Store استفاده ميكنم.براي همين قسمت Model و Controllers رو نمينويسم. براي نوشتن متد كمكي از Helper@ استفاده ميكنم و بقيه مراحل دقيقا مثل نوشتن يك متد عاديه البته تنها فرقش با متد اينه كه بدنه ي متد فقط شامل كدهاي C#‎ نيست. @helper PriceHighlighter(decimal inputPrice, decimal treshold) { if (inputPrice > treshold) { <span style="background-color: red">@inputPrice</span> } else { @inputPrice } } همنط...

نکات شرینک کردن فایل های دیتابیس در SQL Server

تصویر
با ايده گرفتن از Arik Poznanski نتيجه گيريم رو از شرينك كردن فايل هاي ديتابيس اول مينويسم «شرينك كردن در صورت نياز» ما دو نوع شرينك كردن داريم شرينك كردن ديتا فايل (خيلي بد) شرينك كردن لاگ فايل (بد) يه سري مفاهيم اوليه در شرينك هست كه در هر دو نوع شرينك ثابته اول اين مفاهيم رو مرور كنيم. وقتي فايل هاي ديتابيس ميخوان بزرگ بشن بر اساس Autogrowth ي كه ست كرديد اون مقدار مورد نظر براي اطمينان از نداشتن بد سكتور بايد zero byte فرمت بشه حال فرض كنيد رشد بانك به صورت درصدي باشه (كه به صورت پيشفرض هست) و ديتابيس شما گيگا بايتي باشه چه حجم زيادي بايد zero byte فرمت بشه و اين يعني افت Performance. البته خبر خوب اينه كه عمل بزرگ شدن فايل از SQL Server 2005 به بعد فقط براي ديتا فايل با zero byte فرمت انجام نميشه ( Instant File Initialization ).همه اينا رو گفتم تا برسم به اينجا كه بزرگ شدن فايل يه عمليات زمانبريه پس اگه شما از نظر حجم Storage مشكلي نداريد تا جاي كه امكان داره فايلهاي ديتابيستون رو شرينك نكنيد. چرا شرينك كردن ديتا فايل خيلي بده! وقتي شما ديتا فايلتون رو ...

استفاده از Hotmail در SQL Server Database Mail

تصویر
نداشتن بكاپ در يك سازمان باعث فاجعه ميشه.اوايل گزينه مد نظرم براي چك كردن Job مربوط به بكاپ گرفتن استفاده از Notifications خود SQL Server و ارسال ايميل بود ولي يه مشكل كوچيك اين وسط بود نداشتن Mail Server در سازمان. تا قبل از اينكه اين مطلب رو بنويسم فكر ميكردم بايد حتما داخل سازمان خودمون Mail Server داشته باشيم.اين برداشت من داخل كلاس بود.اينم مدركش (به احتمال زياد من مطلب رو بد گرفته بودم!) با اين فكر غلط هروز صبح بايد اين كوئري رو اجرا ميكردم SELECT CAST(CONVERT(DATETIME , CAST(run_date AS CHAR(8)) , 101) AS CHAR(11)) AS 'Failure Date' , SUBSTRING(T2.name , 1 , 100) AS 'Job Name' , T1.step_id AS 'Step #' , T1.step_name AS 'Step Name' , T1.message AS 'Message' FROM msdb..sysjobhistory T1 JOIN msdb..sysjobs T2 ON T1.job_id = T2.job_id WHERE T1.run_status != 1 AND T1.step_id != 0 AND run_date >= CONVERT(CHAR(8) , ( SELECT ...

اصل Dependency Inversion چیست؟

تصویر
در سري پست هاي تعريف اصول SOLID  با اصل Single Responsibility اصل Open Closed اصل Liskov Substitution اصل Interface segregation آشنا شديم در اين پست پنجمین اصل يعني Dependency inversion رو برسي ميكنيم. هدف Dependency inversion اینه که کلاس های سطح بالا نبایستی به صورت مستقیم وابسته به کلاس های سطح پایین باشن بلکه رابطه ی بین کلاس ها بایستی براساس Abstract ها یا Interface ها باشه. بعنوان مثال اگه کلاس سطح بالای سیستم رو business logic بدونیم و این سطح وابسته به جزئیات سطح پایین مثلا ذخیره در بانک اطلاعاتی باشه استفاده مجدد از کلاس های business logic مارو کم میکنه انجام تست روی کلاس های business logic ما سخت میشه عکس زیر برگرفته از کتاب Dependency Injection in .NET هست که Dependency Injection (الگويي براي رعايت اين اصل) رو بخوبی توضیح داده مدير يك هتل ارزان قيمت براي اينكه سشوار دزيده نشه اونو به پريز بسته و اين يعني وابستگي بين سشوار و پريز تغيير در هركدوم ;ديگري رو تحت تاثير قرار ميده. و اما براي مثال عملي فرض كنيد کلاسی بنام GetMessag...

اصل Interface Segregation چیست؟

تصویر
در سري پست هاي تعريف اصول SOLID  با اصل Single Responsibility اصل Open Closed اصل Liskov Substitution آشنا شديم در اين پست چهارمین اصل يعني Interface Segregation رو برسي ميكنيم. همنطور که قبلا اشاره کردم هدف این اصل اینه که اینترفیس بزرگ رو براساس استفاده کننده های اون اینترفیس و اهداف مختلف به اینترفیس های کوچکتر تبدیل کنیم و در نتیجه یک استفاده کننده از اون اینترفیس (مثلا یک کلاس) رو مجبور به پیاده سازی متدهای که بهشون نیاز نداره نکنیم و کلاس های پیچیده هم بجای استفاده از یک اینترفیس بزرگ از چندین اینترفیس استفاده کنن. توجه کنید که اگه ما کلاسی رو مجبور کنیم مثلا یک متد رو که اصلا بهش نیاز نداره پیاده سازی کنه و برای مثال بیاد تو اون متد NULL برگردونه یا مثلا Exception صادر کنه علاوه بر نقض اصل  Interface Segregation ;در ارث بری ما اصل Liskov Substitution رو هم نقض کردیم. به عکس زیر توجه کنید فرض کنید تو یک پروژه Web بخواهید ASP.NET Membership رو شخصی سازی کنید و مثلا قسمت بازیابی با ایمیل رو تغییر بدید تقریبا میشه گفت بیخیال این کار میشید ...

اصل Liskov Substitution چيست؟

در سري پست هاي تعريف اصول SOLID  با اصل Single Responsibility اصل Open Closed آشنا شديم در اين پست سومين اصل يعني Liskov substitution رو برسي ميكنيم. هدف اين اصل اينه كه در ارث بري كلاس مشتق شده بايد به گونه اي طراحي بشه كه در صورت نياز با كلاس پايه ي خودش قابل تعويض باشه. مثال ي كه تو تعاريف اين اصل معمولا مطرح ميشه آيا مربع يك مستطيل هست؟ در منطق هندسه یک مربع نوع خاصی از مستطیل هست که دارای چهار ضلع مساوی میباشد ولي در شي گرائي داستان چيز ديگس… در واقع ما با ارث بردن كلاس مربع از كلاس مستطيل اصل Liskov substitution رو نقض ميكنيم چون با فرض وجود متد هاي setWidth و setHeight در كلاس مستطيل ما مجبوريم اين متد ها رو به گونه ي در كلاس مربع تغيير بديم كه طول و عرض يكي بشه و از اين رو كلاس مشتق شده يعني مربع قابل تعويض با كلاس پايه يعني مستطيل نيست و… اين اصل با اصل Open Closed ارتباط داره توجه كنيد اگه شما نتونيد از كلاس مشتق شدتون بجاي كلاس پايه استفاده كنيد در واقع و بنوعي اصل Open Closed رو رعايت نكرديد. و اما براي مثال عملي فرض كنيد كلا...

اصل Open Closed چيست؟

در سري پست هاي تعريف اصول SOLID  با اصل Single Responsibility آشنا شديم در اين پست دومين اصل يعني Open Closed رو برسي ميكنيم. اين اصل ميگه يك كلاس بايد براي توسعه باز و براي تغيير بسته باشه بنابراين طراحي شما بايد به گونه ي باشه كه براي اضافه كردن يك قابليت جديد به كلاستون حداقل تغيير ممكن رو تو كلاستون داشته باشيد.در واقع بايد براي اضافه كردن قابليت جديد از كلاس جديد استفاده كنيم چون فرض شده تغيير تو كلاسي كه قبلا ساخته شده و داره ازش استفاده ميشه منجر به نتايج ناخواسته (باگ و…) در استفاده كننده هاي اين كلاس (مثلا يك كلاس ديگر) ميشه. ابهامات احتمالي كلاسي كه نبايد تغيير كنه پس نياز به تست واحد هم نداره؟ اگه كلاس باگ داشت چي(نياز به تغيير)؟ جواب بعضي از اين ابهامات + و + (شايد نادرست) حتي اگه شما اصل Open Closed رو رعايت كرده باشيد امكانش هست سهوا يك كلاس رو تغيير بديد پس تست واحد رو داشته باشد! كلاسي كه براي اولين بار طراحي شده براي صحت عملكرد بايد تست بشه پس شما تست واحد رو از قبل داريد(توجيه خوبي براي اولين ابهام) مورد استفاده اين اصل ب...

اصل Single Responsibility چیست؟

تو دنیای برنامه نویسی و البته شیء گرایی SOLID مجموعه ی از 5 قاعده (اصل) ابتدایی شامل Single responsibility Open-closed Liskov substitution Interface segregation Dependency inversion هست و توسط رابرت مارتین در اوایل سال 2000 معرفی شده و … شاید اکثرا با تعاریف این اصول آشنا باشین (درست یا غلط)  ولی بشخصه زیاد با مثال های که تو تاپیک های از این دست زده میشه مشکل دارم(انواع و اقسام اشکال هندسی)  قصد دارم این اصول رو با مثال های نزدیکتر با دنیای واقعی شرح بدم منظور مثال های از برنامه های تجاری(البته اگه پیدا کنم) قبل از شروع از اساتید و دوستانی که (شاید) این پست رو میبینن درخواست میکنم در صورت خطا (برداشت غلط و…) تو مطالب و مثال های ارائه شده منو راهنمایی کنن. اصل Single responsibility تعریف کردن این اصل خیلی راحته ولی انجامش در عمل سخته و تقریبا میشه گفت مثل امنیت همیشه %100 نیست. این اصل میگه هر کلاس فقط باید یک مسئوليت داشته و همچنیا میگه هر کلاس باید یک دلیل برای تغییر داشته باشه همونطور که گفتم راحت ت...

الگوهای ابتدایی برای برنامه نویسی دات نت

در این پست چند الگوی شاید معمولی ولی بسیار مهم لیست شده.مطلب جالبیه تنها مشکلش اینه که مثال های اون به هر زبانی هست جز #C. تو این پست معادل های دات نت ی اون لیست شده. 1-ارزیابی موجود بودن یک شی (null نبودن) قبل از فراخوانی متدها و خواص های اون تکنیکی به نام “andand” وجود داره که طی اون هنگام فراخوانی مثلا یک متد یک شی نام اون شی رو با فراخوانی متدش AND منطقی میکنیم و این باعث میشه تنها در صورتی که شی ما موجود باشه (null نباشه) متد مربوطه فراخوانی شه. به این مثال تو زبان JavaScript توجه کنید var parsed_content = window.JSON && window.JSON.parse("{}"); تا جایی که من میدونم و سرچ هم کردم چنین ویژگی تو #C موجو نیست. و اما این کار رو به روش های دیگه ی میشه انجام داد مثلا با یه IF قبلش چک کنیم شی ما null نباشه تنها مشکلش اینه که در صورتی که شی ما تو در تو باشه تعداد IF های ما زیاد میشه. const string xmlDoc = @" <opml version=""1.0""> <head> ...

مقدمه ای بر RavenDB – قسمت سوم

تصویر
در دو قسمت اول و دوم “مقدمه ای به RavenDB” به آشنایی با مقدمات RavenDB پرداختیم تو این قسمت میخواهیم با یک مثال در عمل با RavenDB آشنا بشیم. برای شروع یک پروژه ASP.NET MVC 3 رو ایجاد میکنیم. اگه از قسمت اول یادتون باشه گفتم یکی از 4 روش راه اندازی (هاست کردن) RavenDB به صورت مدفون شده یا Embed هست برای استفاده از این روش کافیه پکیج RavenDB-Embedded رو با NuGet نصب کنیم. همونطور که قبلا گفتم RavenDB به صورت schema-less هست ازاینرو برای کار با بانک نیاز نیست شما بانک و جدولی رو از قبل بسازید (کاری که با بانک های Embedded دیگه مثله SQL Server Compact انجام میدیم) تنها پس از اولین فراخوانی متد initialize شی DocumentStore ما فایل های مربوطه (همان بانک RavenDB) ساخته میشه. برای ذخیره بانک ما از پوشه استاندارد App_Data استفاده میکنیم. در طول چرخه حیاط یک برنامه بایستی یکه وهله از بانک در دسترس باشه ازاینرو از الگوی Singleton استفاده میکنیم. public class DataDocumentStore { private static IDocumentStore _instance; public static IDocumentStore Instance { get ...

مقدمه ای بر RavenDB – قسمت دوم

تصویر
در پست قبلی با استفاده از Management Studio دیتای تستی ساختیم. حالا یه شرح مختصری از سند و مجموعه سند ( document ) چیست؟ سند در واقع یک شی JSON هست و معادل یک ردیف (رکورد) تو بانک های رابطه ای RDBMS محسوب میشه برای آشنایی بیشتر با ساختار سند روی یکی از سند های ایجاد شده کلیک و دکمه Edit رو بزنید. همونطور که تو شکل میبینید یکه سند شامل یک کلید , دیتا و متا دیتا هست. کلید (تو این شکل albums/20) رو میشه با PK یا کلید اصلی تو بانک های رابطه ای RDBMS قیاس کرد. دیتا در واقع کل شی(در اینجا آلبوم) شما در فرمت JSON هستش. متا دیتا هم بصورت اتومات ایجاد میشه مثلا در این شکل Raven-Clr-Type یکه شی دات نت ی هست که به سند ما مپ شده. Raven برای اختصاص کلید به هر سند از روش guid ترتیبی (sequential guid) استفاده میکنه که هم بصورت جهانی یکتا هست و هم با توجه به ترتیبی بودن به خوبی ایندکس میشه البته توجه کنید برای اختصاص کلید به یک سند میشه کلید رو به صورت صریح مشخص کرد و هم کلید رو به صورت Identity key اختصاص داد.خود Raven بصورت داخلی از Identity key پشتیبانی میکنه(تو پست های بع...