مدیریت datasetها در Postman

بعد از ساخت dataset، باید data sourceها و viewهای آن را با تغییر workflowهای خود به‌روز نگه دارید. با مدیریت درست dataset می‌توانید داده‌های تست، script و mock server را از یک نقطه کنترل کنید.

Datasetها در پلن‌های Solo، Team و Enterprise در دسترس هستند. در Local View، هر dataset با یک فایل YAML در Git repository محلی workspace تعریف می‌شود.

مدیریت خود dataset #

برای مدیریت یک dataset:

1. در sidebar روی Items کلیک کنید.
2. Datasets را انتخاب کنید.
3. کنار dataset موردنظر، منوی View more actions را باز کنید.

از این منو می‌توانید کارهای زیر را انجام دهید:

• Rename: تغییر نام dataset
• Edit YAML: فقط در Local View، باز کردن و ویرایش مستقیم فایل YAML dataset
• Delete: حذف dataset از workspace

مدیریت data sourceها #

Data source مشخص می‌کند داده dataset از کجا می‌آید؛ مثل فایل داده یا اتصال دیتابیس. یک dataset می‌تواند چند data source داشته باشد.

افزودن data source جدید #

1. از sidebar وارد Items شوید.
2. Datasets را انتخاب کنید.
3. کنار dataset، در بخش Sources گزینه Add source را بزنید.
4. Add New Source را انتخاب کنید.
5. نوع data source را انتخاب کنید.
6. تنظیمات آن را کامل کنید.
7. در صورت نیاز، data sourceهای بیشتری اضافه کنید.
8. Save را بزنید.

اگر یک data source را حذف کنید، viewهایی که از آن استفاده می‌کنند خراب می‌شوند. پس بعد از حذف، queryهای viewها را هم بررسی و اصلاح کنید.

به‌روزرسانی data source موجود #

1. از Items وارد Datasets شوید.
2. data source موردنظر را انتخاب کنید.
3. تنظیمات آن را متناسب با نوع data source تغییر دهید.
4. برای دیدن آخرین داده فایل یا دیتابیس، Refresh را بزنید.
5. پیش‌نمایش داده را از تب Data بررسی کنید.

برای هر data source می‌توانید نام را تغییر دهید یا آن را حذف کنید. حذف data source داده اصلی را از دیتابیس یا فایل خارجی الزاماً حذف نمی‌کند، اما ارتباط آن را از dataset برمی‌دارد.

به‌روزرسانی data source با Agent Mode #

Agent Mode می‌تواند برای تولید یا تغییر داده نمونه در فایل‌های CSV و JSON کمک کند. مثال:

Add 5 new users with realistic data to my dataset, including userId, name, and email fields.

اگر data source شما به دیتابیس وصل است، می‌توانید از Agent Mode بخواهید داده نمونه تولید و در جدول وارد کند:

Generate 10 sample orders with realistic data and insert them into the orders table in my connected MySQL database.

بعد از تغییر data source، آن را refresh کنید و در صورت نیاز viewها را هم به‌روزرسانی کنید.

مدیریت viewها #

View مشخص می‌کند داده چطور از dataset خوانده شود. با view می‌توانید داده را فیلتر، ترکیب یا تبدیل کنید. برای نمونه، یک view می‌تواند فقط سناریوهای تست خاص را برگرداند یا با query ستون‌های جدید بسازد.

برای افزودن یا تغییر view:

1. از Items وارد Datasets شوید.
2. برای ساخت view جدید، کنار Views گزینه Add view را بزنید؛ یا یک view موجود را انتخاب کنید.
3. یک query سازگار با SQLite وارد کنید.
4. Run را بزنید تا query اجرا شود.
5. در table pane، نتیجه query را preview و search کنید.

Viewها می‌توانند از چند data source داده بگیرند، اما نمی‌توانند data source محلی و cloud-based را با هم ترکیب کنند.

اشتراک‌گذاری dataset #

در Cloud View می‌توانید لینک مستقیم dataset، data source یا view را با تیم خود به اشتراک بگذارید. از مسیر Items > Datasets آیتم موردنظر را باز کنید و از بالای صفحه Copy link را بزنید.

Push و pull کردن datasetها #

با push، آخرین نسخه dataset از workspace محلی به cloud Postman sync می‌شود. فایل‌های محلی که push می‌شوند به cloud file تبدیل می‌شوند.

با pull، آخرین نسخه dataset از cloud Postman به workspace محلی شما sync می‌شود. Cloud fileهایی که pull می‌شوند در Git repository محلی شما به فایل محلی تبدیل می‌شوند.

عیب‌یابی datasetها #

اگر کنار dataset در sidebar علامت خطا مثل (!) دیدید، معمولاً یکی از این موارد رخ داده است:

• Dataset out of sync: ممکن است فایل‌های dataset را بیرون از Postman ویرایش کرده باشید یا merge conflict وجود داشته باشد. Postman را restart کنید تا فایل‌ها دوباره sync شوند.
• Invalid or corrupted dataset files: فایل dataset ممکن است format یا محتوای نامعتبر داشته باشد. فایل‌های local Git repository را بررسی کنید یا نسخه سالم قبلی را برگردانید.

منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.