نام (NAME)

createdb - ساخت یک پایگاه‌داده جدید PostgreSQL

خلاصه دستور (SYNOPSIS)

createdb [connection-option...] [option...] [dbname [description]]

توضیحات (DESCRIPTION)

دستور createdb یک پایگاه‌داده جدید PostgreSQL ایجاد می‌کند.

به‌طور معمول، کاربر پایگاه‌داده‌ای که این دستور را اجرا می‌کند، مالک پایگاه‌داده جدید می‌شود. با این حال، در صورتی که کاربر اجراکننده دارای اختیارات لازم باشد، می‌توان با استفاده از گزینه -O مالک متفاوتی را مشخص کرد.

دستور createdb پوششی پیرامون دستور SQL با نام CREATE DATABASE است. در عمل هیچ تفاوتی میان ایجاد پایگاه‌های داده از طریق این ابزار و روش‌های دیگر برای دسترسی به سرور وجود ندارد.

گزینه‌ها (OPTIONS)

دستور createdb آرگومان‌های خط فرمان زیر را می‌پذیرد:

dbname

description

-D tablespace
--tablespace=tablespace

-e
--echo

-E encoding
--encoding=encoding

-l locale
--locale=locale

--lc-collate=locale

--lc-ctype=locale

--builtin-locale=locale

--icu-locale=locale

--icu-rules=rules

--locale-provider={builtin|libc|icu}

-O owner
--owner=owner

-S strategy
--strategy=strategy

-T template
--template=template

-V
--version

-?
--help

گزینه‌های -D، -l، -E، -O و -T متناظر با گزینه‌های دستور SQL زیربنایی CREATE DATABASE هستند؛ برای کسب اطلاعات بیشتر درباره آن‌ها به مستندات آن دستور مراجعه کنید.

دستور createdb همچنین آرگومان‌های خط فرمان زیر را برای پارامترهای اتصال می‌پذیرد:

-h host
--host=host

-p port
--port=port

-U username
--username=username

-w
--no-password

-W
--password

--maintenance-db=dbname

محیط (ENVIRONMENT)

PGDATABASE

PGHOST
PGPORT
PGUSER

PG_COLOR

این ابزار، مانند اغلب ابزارهای دیگر PostgreSQL، از متغیرهای محیطی پشتیبانی‌شده توسط libpq نیز استفاده می‌کند (به بخش 32.15 مراجعه فرمایید).

خطاها (DIAGNOSTICS)

در صورت بروز مشکل، برای بررسی مسائل احتمالی و پیام‌های خطا به CREATE DATABASE (CREATE_DATABASE(7)) و psql(1) مراجعه کنید. سرور پایگاه‌داده باید روی میزبان هدف در حال اجرا باشد. همچنین، هرگونه تنظیمات پیش‌فرض اتصال و متغیرهای محیطی مورد استفاده توسط کتابخانه پیشانه libpq اعمال خواهد شد.

مثال‌ها (EXAMPLES)

برای ساخت پایگاه‌داده demo با استفاده از سرور پایگاه‌داده پیش‌فرض:

$ createdb demo

برای ساخت پایگاه‌داده demo روی میزبان eden، پورت 5000، با استفاده از پایگاه‌داده الگوی template0، دستور خط فرمان و دستور SQL زیربنایی مربوط به آن به شکل زیر است:

$ createdb -p 5000 -h eden -T template0 -e demo
CREATE DATABASE demo TEMPLATE template0;

همچنین ببینید (SEE ALSO)

dropdb(1), CREATE DATABASE (CREATE_DATABASE(7))