در یویو-مهاجرت ابزار پایگاه داده مهاجرت طرح با استفاده از SQL ساده و DB-API است.
یویو-مهاجرت چکار می کند؟
برنامه های کاربردی پایگاه داده تکامل، تغییرات به شمای پایگاه داده اغلب مورد نیاز است. این می تواند به عنوان اسکریپت SQL یکی کردن که شامل ایجاد / تغییر اظهارات جدول (اگر چه هر SQL و یا پایتون اسکریپت ممکن است با نوعی اسباب بازی بچگانه-مهاجرت استفاده می شود) نوشته شود.
یویو-مهاجرت فراهم می کند یک ابزار خط فرمان برای خواندن یک دایرکتوری از جمله اسکریپت و استفاده از آنها را به پایگاه داده خود را به عنوان مورد نیاز است.
پشتیبانی از پایگاه داده
پایگاه های داده PostgreSQL، MySQL و SQLite است پشتیبانی می شوند.
استفاده
یویو-مهاجرت معمولا به عنوان یک اسکریپت خط فرمان حق استفاده نمود.
مثال:
خواندن تمام مهاجرت از مهاجرت دایرکتوری و اعمال آنها را به یک پایگاه داده PostgreSQL و:
یویو-مهاجرت درخواست ./migrations/ POSTGRES: // کاربری: رمز عبور @ localhost را / پایگاه داده
مهاجرت عقبگرد قبلا به پایگاه داده MySQL استفاده شود:
یویو-مهاجرت عقبگرد ./migrations/ خروجی زیر: // کاربری: رمز عبور @ localhost را / پایگاه داده
درخواست مجدد (یعنی عقبگرد سپس دوباره در نظرگرفته شود) مهاجرت به دیتابیس SQLite در محل /home/sheila/important-data.db:
یویو-مهاجرت از SQLite درخواست مجدد ./migrations/: ////home/sheila/important-data.db
به طور پیش فرض، نوعی اسباب بازی بچگانه-مهاجرت شروع می شود در حالت تعاملی، و از شما برای هر فایل مهاجرت قبل از استفاده از آن، ساخت آن آسان را انتخاب کنید که مهاجرت به اعمال و عقبگرد.
دایرکتوری مهاجرت باید یک سری از اسکریپت مهاجرت باشد. هر اسکریپت مهاجرت یک فایل پایتون (.py) حاوی یک سری از مراحل است. هر مرحله باید یک پرس و جو مهاجرت و (اختیاری) یک پرس و جو عقبگرد تشکیل می دهند. برای مثال:
#
# فایل: مهاجرت / 0001.create-foo.py
#
گام (
و nbsp؛ "ایجاد جدول مواد غذایی (شناسه INT، نوار VARCHAR (20)، کلید اصلی (ID))"،
و nbsp؛ "DROP TABLE غذ"،
)
نام فایل هر فایل (بدون پسوند .py) به عنوان شناسه برای هر مهاجرت استفاده می شود. مهاجرت در نام فایل منظور اعمال، پس از آن مفید به نام فایل های خود را با استفاده از یک تاریخ (مثلا 20090115-xyz.py ') و یا با یکی دیگر از تعداد افزایش.
یویو-مهاجرت ایجاد یک جدول در پایگاه داده هدف، _yoyo_migration خود، برای پیگیری مهاجرت اعمال شده است.
مراحل نیز ممکن است ignore_errors آرگومان اختیاری، که باید یکی از درخواست، عقبگرد، یا تمام شود را. اگر در مثال قبلی جدول مواد غذایی ممکن است در حال حاضر با استفاده دیگری ایجاد شده است، ما می تواند ignore_errors اضافه = 'درخواست' به مرحله به اجازه مهاجرت به ادامه بدون در نظر گرفتن:
#
# فایل: 0001.create-foo.py
#
گام (
و nbsp؛ "ایجاد جدول مواد غذایی (شناسه INT، نوار VARCHAR (20)، کلید اصلی (ID))"،
و nbsp؛ "DROP TABLE غذ"،
& nbsp؛ در ignore_errors = 'درخواست'،
)
مراحل همچنین می توانید پایتون اشیاء صدازدنی که یک اتصال به پایگاه داده به عنوان آرگومان خود باشد. برای مثال:
#
# فایل: 0002.update_keys.py
#
دف do_step (هدایت کردن):
& nbsp؛ از مکان نما = conn.cursor ()
& nbsp؛ در cursor.execute (
و nbsp؛ "درج sysinfo"
و nbsp؛ "(osname، نام میزبان، انتشار، نسخه، قوس)"
& nbsp؛ از "ارزشهای (٪ S،٪ S،٪ S،٪ S،٪ s را از٪ s)"،
را لمس کنید و. os.uname ()
و nbsp؛)
گام (do_step)
امنیت رمز عبور
شما به طور معمول نام کاربری پایگاه داده و رمز عبور خود را به عنوان بخشی از رشته اتصال به پایگاه داده در خط فرمان مشخص کنید. در یک ماشین چند کاربر، کاربران دیگر می تواند رمز عبور پایگاه داده خود را در لیست پروسه ببینید.
-p یا --prompt-رمز عبور پرچم باعث نوعی اسباب بازی بچگانه-مهاجرت به بی درنگ برای یک رمز عبور، نادیده گرفتن هر رمز عبور مشخص شده در رشته اتصال. این رمز عبور در دسترس نخواهد بود را به کاربران دیگر از طریق لیست پروسه سیستم باشد.
اتصال ذخیره رشته
اولین بار اجرا می کنید یویو-مهاجرت در مجموعه ای جدید از مهاجرت، از شما خواسته خواهد شد اگر شما می خواهید به کش رشته اتصال به پایگاه داده در یک فایل با نام .yoyo-مهاجرت در دایرکتوری مهاجرت.
این حافظه پنهان محلی به دایرکتوری مهاجرت است، بنابراین اجرا می شود پس از آن بر روی مجموعه ای مهاجرت همین کار را رشته اتصال به پایگاه داده به مشخص شود نیاز ندارد.
این موجب صرفه جویی تایپ، اجتناب نام کاربری پایگاه داده و رمز عبور خود نمایش در لیست فرآیند و کاهش خطر ابتلا به طور تصادفی در حال اجرا یویو-مهاجرت در پایگاه داده اشتباه (یعنی با اجرای مجدد یک ورودی یویو-مهاجرت پیش از آن در تاریخ فرمان خود را هنگامی که شما به یک نقل مکان کرد دایرکتوری های مختلف).
اگر این فایل ذخیره سازی می خواهید به مورد استفاده قرار گیرد، اضافه کردن پارامتر وجود ندارد-کش به گزینه های خط فرمان
چه در این نسخه جدید است.
رفع برای سوء مدیریت 4.2.3 انتشار
جدید در نسخه 4.2.1 است:
در Bugfix برای نسخه قبلی، که حذف فایل های حیاتی است.
چه در نسخه 4.1.6 جدید است:
اضافه شدن پشتیبانی از ویندوز (به لطف پیتر Shinners)
جدید در نسخه 4.1.5 است:
پیکربندی گرداننده ورود به سیستم به طوری که سوئیچ -v باعث خروجی برای رفتن به کنسول (به لطف اندرو Nelis).
`` -v`` سوئیچ خط فرمان دیگر طول می کشد یک آرگومان اما ممکن است چندین بار مشخص شده به جای (به عنوان مثال استفاده `` -vvv`` به جای `` -v3``). `` --verbosity`` رفتار قدیمی حفظ کرده است.
جدید در نسخه 4.1.3 است:
به مهاجرت به طور پیش فرض تغییر نام جدول بازگشت به '_yoyo_migration'
مورد نیاز:
پایتون
نظر یافت نشد