در Postman، dataset یک منبع داده قابل استفاده مجدد برای workflowهای API است. با dataset می‌توانید تست‌های داده‌محور اجرا کنید، پاسخ‌های mock server را پویا بسازید، و داده مشترک را در scriptها و collection runها به کار ببرید.
Datasetها در پلن‌های Solo، Team و Enterprise در دسترس هستند. هر dataset در Local View به شکل یک فایل YAML نگهداری می‌شود و شامل data sourceها و viewها است.
dataset از چه بخش‌هایی تشکیل می‌شود؟
- Data source: مشخص می‌کند داده از کجا می‌آید؛ مثل فایل CSV یا JSON، فایل cloud در Postman، یا اتصال خارجی مثل MySQL و PostgreSQL.
- View: یک query با syntax سازگار با SQLite است که مشخص می‌کند چه داده‌ای از data source خوانده شود. با view می‌توانید داده را انتخاب، فیلتر، ترکیب یا تبدیل کنید.
ساخت یک dataset
برای ساخت dataset در Postman این مراحل را انجام دهید:
- از sidebar سمت چپ گزینه افزودن را انتخاب کنید و Dataset را بزنید.
- در صورت نیاز، نام و توضیح dataset را وارد کنید.
- از فهرست data source، نوع منبع داده را انتخاب کنید. بعد از ساخت data source نمی‌توانید نوع آن را تغییر دهید.
- تنظیمات data source را کامل کنید.
- در صورت نیاز، با Add New Source چند data source دیگر اضافه کنید.
- Save را بزنید.
Postman برای هر data source یک view پیش‌فرض می‌سازد که همه داده‌ها را انتخاب می‌کند. بعداً می‌توانید data sourceها و viewها را بر اساس سناریوهای تست، script و mock server تغییر دهید.
ساخت dataset با Agent Mode
می‌توانید از Agent Mode بخواهید یک dataset نمونه برایتان بسازد. Agent Mode می‌تواند فایل CSV یا JSON با داده واقع‌گرایانه تولید کند تا بدون ساخت دستی داده، سریع شروع کنید.
Create a dataset with sample user data, including userId, name, and email fields. Generate about 10 rows.بعد از تولید dataset، می‌توانید viewهای بیشتری اضافه کنید؛ مثلاً view برای فیلتر کردن کاربران بر اساس نام یا انتخاب فقط چند ستون مشخص.
فایل YAML dataset
در برنامه دسکتاپ Postman و Local View، هر dataset با یک فایل YAML تعریف می‌شود. این فایل data sourceها، viewها، نام، ID و metadata مربوط به dataset را نگه می‌دارد.
/postman/datasets/<dataset-name>/<dataset-name>.dataset.yamlاین فایل در Git repository محلی workspace ذخیره می‌شود و منبع اصلی تنظیمات dataset است. تغییراتی که در Postman انجام می‌دهید در این فایل منعکس می‌شود، و تغییرات فایل هم در Postman دیده می‌شود.
نوع‌های data source
یک dataset می‌تواند چند data source داشته باشد. Postman از فایل محلی، دیتابیس MySQL، دیتابیس PostgreSQL و Postman cloud file پشتیبانی می‌کند.
فایل محلی
می‌توانید یک فایل CSV یا JSON را از سیستم خود انتخاب کنید. در Local View، گزینه Copy file to workspace به صورت پیش‌فرض فعال است تا فایل در Git repository محلی workspace کپی شود و همراه workspace قابل اشتراک‌گذاری باشد. این گزینه برای فایل‌های بزرگ در دسترس نیست.
دیتابیس MySQL
برای اتصال به MySQL، نوع MySQL را انتخاب کنید و اطلاعات زیر را وارد کنید:
- Host: hostname یا IP سرور MySQL
- Port: پورت MySQL
- Database: نام دیتابیس
- Username: نام کاربری اتصال
- Password: رمز عبور اتصال
- Table: نام جدول
با Test connection مطمئن شوید Postman می‌تواند به دیتابیس وصل شود. اطلاعات حساس مثل host و password را بهتر است در Postman Vault به شکل vault secret نگه دارید.
دیتابیس PostgreSQL
برای PostgreSQL هم اطلاعات اتصال مشابه MySQL است، با این تفاوت که باید Schema را هم وارد کنید. بعد از کامل کردن host، port، database، username، password، table و schema، اتصال را با Test connection بررسی کنید.
Postman cloud file
در Cloud View می‌توانید یک فایل CSV از سیستم خود انتخاب کنید. این فایل در cloud Postman ذخیره می‌شود و از دستگاه‌های مختلف یا توسط اعضای تیم قابل دسترسی است.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.