افزودن اتصال پایگاه‌داده

اتصال، اطلاعاتی است که اوبا با آن به منبع دادهٔ شرکت وصل می‌شود: نوع پایگاه‌داده، نشانی سرور، نام پایگاه‌داده و کاربر فقط‌خواندنی. تا وقتی شرکت دست‌کم یک اتصال نداشته باشد، گفت‌وگو با داده ممکن نیست و پیام «برای کار با داده‌ها ابتدا باید یک اتصال پایگاه‌داده برای شرکت شما ثبت شود» نمایش داده می‌شود.

پیش از شروع

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

ساخت اتصال

در منوی کناری، «داده و اتصال‌ها» › «اتصال‌های پایگاه‌داده» را باز کنید و «افزودن اتصال» را بزنید. صفحهٔ «افزودن اتصال» با چند گام باز می‌شود؛ گام فعلی در بالای صفحه مشخص است. (در راه‌اندازی اولیهٔ شرکت، همین گام‌ها در مرحلهٔ «اتصال پایگاه‌داده» نمایش داده می‌شوند.)
گام «نوع»: روی کارت نوع منبع بزنید؛ با «جستجوی نوع پایگاه‌داده» زودتر پیدا می‌شود. با زدن کارت، گام بعدی باز می‌شود. انواعی که «(بتا)» دارند هنوز آزمایشی‌اند.
گام «نشانی و ورود»: کادر «پیش از ادامه» IP سرور اوبا را (با دکمهٔ کپی) و یادآوری ساخت کاربر فقط‌خواندنی را نشان می‌دهد. «میزبان»، «درگاه»، «نام کاربری» و «گذرواژه» را وارد کنید و اگر لازم است «حالت SSL» را در بخش «امنیت ارتباط» تعیین کنید. با «آزمایش اتصال» می‌توانید همین‌جا درستی اطلاعات را بسنجید. سپس «بعدی» را بزنید.
گام «پایگاه‌داده» (فقط برای انواعی که روی یک سرور چند پایگاه‌داده دارند): اوبا فهرست پایگاه‌داده‌هایی را که همین کاربر می‌بیند خودکار می‌خواند. یکی را با «انتخاب از فهرست» برگزینید یا نامش را بنویسید.
در آخرین گام، در «نام اتصال» نامی بنویسید که موضوع را روشن کند، مثلاً «فروش و انبار — نسخهٔ گزارش‌گیری». در «تنظیمات پیشرفته (اختیاری)» می‌توانید گزینه‌های پیشرفته را از همین حالا تنظیم کنید.
«افزودن اتصال» را بزنید. پیام‌های «در حال ساخت اتصال…» و سپس «در حال آزمایش اتصال…» یعنی اتصال ساخته و یک بار آزمایش می‌شود. پس از آن، صفحهٔ همان اتصال با زبانهٔ «وضعیت» باز می‌شود.

با «قبلی» یا با زدن گام‌های گذشته در بالای صفحه به عقب برگردید؛ اطلاعات واردشده حفظ می‌شود. اگر پیش از پایان از صفحه بیرون بروید، اوبا پیش از کنار گذاشتن اطلاعات واردشده از شما می‌پرسد.

فیلدهای فرم

«میزبان»: نشانی یا نام سرور پایگاه‌داده.
«درگاه»: پورت پایگاه‌داده؛ برای هر نوع، مقدار پیش‌فرض پر می‌شود.
«نام پایگاه‌داده»: پایگاه‌داده‌ای که پرسش‌ها از آن پاسخ داده می‌شوند.
«نام کاربری» و «گذرواژه»: اطلاعات کاربر فقط‌خواندنی. گذرواژهٔ ذخیره‌شده هرگز نمایش داده نمی‌شود.
«حالت SSL» (بخش «امنیت ارتباط»): گزینه‌ها به زبان ساده نوشته شده‌اند، مانند «در صورت امکان رمزگذاری شود (prefer)» یا «همیشه رمزگذاری شود (require)». اگر سرور شما ارتباط رمزگذاری‌شده می‌خواهد، حالت مناسب را از مدیر پایگاه‌داده بپرسید.
«بدون نام کاربری و رمز عبور (این پایگاه‌داده احراز هویت ندارد)»: فقط برای انواعی که این امکان را دارند نمایش داده می‌شود.
«تنظیمات پیشرفته (اختیاری)»: «به‌روزرسانی شبانه»، «حالت پایگاه‌دادهٔ بزرگ» و «حداکثر زمان اجرای هر پرس‌وجو (ثانیه)»، هر کدام فقط برای انواعی که آن را پشتیبانی می‌کنند. توضیح هر یک در تنظیمات پیشرفتهٔ اتصال آمده است و بعداً هم در زبانهٔ «پیشرفته» تغییر می‌کنند.

افزودن فایل Excel یا CSV

در گام «نوع»، کارت «فایل صفحه‌گسترده (Excel / CSV)» را بزنید.
در «فایل داده (xlsx / xls / csv)» فایل را انتخاب کنید. فرمت‌ها و حداکثر حجم مجاز زیر همین فیلد نوشته شده است.
صبر کنید تا پیام «فایل بررسی شد و آمادهٔ افزودن است.» ظاهر شود. فهرست «جدول‌های شناسایی‌شده» و در صورت وجود «هشدارها» و «خطاها» را بخوانید.
«افزودن اتصال» را بزنید. برای این نوع، «آزمایش اتصال» لازم نیست و نمایش داده نمی‌شود.

برای به‌روز کردن داده، در صفحهٔ اتصال به زبانهٔ «تنظیمات اتصال» بروید و از «جایگزینی فایل» استفاده کنید. اگر ساختار فایل عوض شده باشد، مستندات جدول‌ها را بازتولید کنید.

پس از ساخت اتصال

در فهرست «اتصال‌های پایگاه‌داده» هر اتصال یک کارت دارد:

خط سلامت: «متصل · آخرین آزمایش ۲ ساعت پیش» یعنی آخرین آزمایش موفق بوده است؛ با نگه داشتن نشانگر روی زمان، تاریخ دقیق دیده می‌شود. «اتصال برقرار نشد · رفع مشکل» یعنی آخرین آزمایش ناموفق بوده است؛ «رفع مشکل» شما را به زبانهٔ «وضعیت» می‌برد که علت و راه رفع آن را نشان می‌دهد. «آزمایش‌نشده» یعنی اتصال هنوز آزمایش نشده است.
آمادگی: «آمادگی ۳ از ۵» نشان می‌دهد چند گام از فهرست «راه‌اندازی این اتصال» انجام شده است؛ با نگه داشتن نشانگر روی آن، گام‌های باقی‌مانده را می‌بینید. وقتی همهٔ گام‌های لازم انجام شود، «آماده» نوشته می‌شود.
«… مورد نیازمند توجه»: پیوندی به نخستین زبانه‌ای که کاری در آن مانده است.
«پیش‌فرض»: گفتگوهای تازه به‌طور پیش‌فرض از این اتصال استفاده می‌کنند.
«آزمایش اتصال» و منوی «گزینه‌های بیشتر» با «تنظیمات اتصال»، «تنظیم به‌عنوان پیش‌فرض» و «حذف اتصال».

با زدن نام اتصال، صفحهٔ همان اتصال با زبانه‌های زیر باز می‌شود (دو زبانهٔ «جدول‌های کد و ارتباط‌ها» و «داده‌های زمانی» فقط برای مدیران اتصال و فقط برای اتصال‌های پایگاه‌داده، نه REST API، نمایش داده می‌شوند):

زبانه	چه چیزی آنجاست	راهنما
«وضعیت»	فهرست «راه‌اندازی این اتصال»، «سلامت اتصال» با «آزمایش اتصال»، «ایمنی» و «توابع منتظر تأیید»	زبانهٔ وضعیت
«دانش داده»	«توضیح پایگاه‌داده» و «مستندات جدول‌ها»	توضیح پایگاه‌داده، مستندات جدول‌ها
«جدول‌های کد و ارتباط‌ها»	جدول‌های کد و ارتباط‌های تشخیص‌داده‌شده برای بازبینی، همراه با راهنمای این بخش	جدول‌های کد و ارتباط‌ها
«داده‌های زمانی»	جدول‌های حسگر و سری زمانی، «راهنمای معنایی داده‌ها» و پیشنهاد جدول خلاصه، همراه با راهنمای این بخش	داده‌های زمانی
«تنظیمات اتصال»	مشخصات، نشانی و ورود، امنیت ارتباط	تنظیمات اتصال
«کاربران مجاز»	کاربرانی که می‌توانند از این اتصال پرس‌وجو کنند	کاربران مجاز
«پیشرفته»	رفتار اتصال، تشخیص جدول‌های کد و ارتباط‌ها و حذف اتصال	تنظیمات پیشرفته

هر بخش این صفحه یک خط توضیح و پیوند «بیشتر بدانید» به همین راهنما دارد، و دکمهٔ «راهنمای این صفحه» در کنار صفحه مروری کوتاه بر همهٔ زبانه‌ها می‌دهد.

گام مهم بعدی، کامل کردن فهرست «راه‌اندازی این اتصال» در زبانهٔ «وضعیت» است؛ به‌ویژه توضیح پایگاه‌داده و مستندات جدول‌ها. بدون آن‌ها، عامل معنای جدول‌ها را حدس می‌زند.

مثال

مدیر شرکت فرضی «پخش البرز» در گام «نوع» کارت «SQL Server» را می‌زند، نشانی سرور و کاربر ooba_reader را وارد می‌کند و در گام «پایگاه‌داده» پایگاه‌دادهٔ Sales را از فهرست برمی‌گزیند. نام اتصال را «فروش — SQL Server گزارش‌گیری» می‌گذارد و «افزودن اتصال» را می‌زند. زبانهٔ «وضعیت» باز می‌شود؛ خط سلامت «متصل» است و بخش «ایمنی» نشان «فقط‌خواندنی (تأییدشده)» را دارد. سپس از منوی کارت، اتصال را «تنظیم به‌عنوان پیش‌فرض» می‌کند و در زبانهٔ «کاربران مجاز» فقط تیم فروش و مالی را تیک می‌زند.

اشکالات رایج

پیام یا نشانه	علت محتمل	چه کنید
دکمهٔ «افزودن اتصال» نیست	مجوز «افزودن اتصال پایگاه‌داده» را ندارید	از مدیر شرکت بخواهید آن را فعال کند.
«به سقف اتصال‌های پلان رسیده‌اید.»	تعداد اتصال‌های بستهٔ شما پر شده است	اتصال بلااستفاده‌ای را حذف یا بسته را ارتقا دهید.
«اتصالی با این نام قبلاً ثبت شده است»	نام تکراری	نام دیگری بگذارید.
«برای آزمایش، ابتدا فیلدهای اتصال را کامل کنید»	فیلد الزامی خالی است	فیلدهای قرمز را پر کنید.
«برای آزمایش دوبارهٔ اتصال کمی صبر کنید.»	آزمایش‌های پشت‌سرهم	چند لحظه صبر کنید.
«فهرست پایگاه‌داده‌ها خوانده نشد؛ نام آن را بنویسید یا نشانی و ورود را بررسی کنید.»	کاربر اجازهٔ دیدن فهرست پایگاه‌داده‌ها را ندارد یا ورود نادرست است	نام پایگاه‌داده را بنویسید، یا با «قبلی» نشانی و ورود را اصلاح کنید.