'\" t
.\"     Title: createdb
.\"    Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026
.\"    Manual: PostgreSQL 18.6 Documentation
.\"    Source: PostgreSQL 18.6
.\"  Language: English
.\"
.TH "CREATEDB" "1" "2026" "PostgreSQL 18.6" "PostgreSQL 18.6 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
createdb \- ساخت یک پایگاه‌داده جدید PostgreSQL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBcreatedb\fR\ 'u
\fBcreatedb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\fIdbname\fR\ [\fIdescription\fR]]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
createdb
یک پایگاه‌داده جدید
PostgreSQL
ایجاد می‌کند\&.
.PP
به‌طور معمول، کاربر پایگاه‌داده‌ای که این دستور را اجرا می‌کند، مالک پایگاه‌داده جدید می‌شود\&. با این حال، در صورتی که کاربر اجراکننده دارای اختیارات لازم باشد، می‌توان با استفاده از گزینه
\fB\-O\fR
مالک متفاوتی را مشخص کرد\&.
.PP
دستور
createdb
پوششی پیرامون دستور
SQL
با نام
\fBCREATE DATABASE\fR
است\&. در عمل هیچ تفاوتی میان ایجاد پایگاه‌های داده از طریق این ابزار و روش‌های دیگر برای دسترسی به سرور وجود ندارد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور
createdb
آرگومان‌های خط فرمان زیر را می‌پذیرد:
.PP
\fIdbname\fR
.RS 4
نام پایگاه‌داده‌ای که باید ایجاد شود را مشخص می‌کند\&. این نام باید میان تمام پایگاه‌های داده
PostgreSQL
در این کلاستر یکتا باشد\&. حالت پیش‌فرض، ساخت پایگاه‌داده‌ای هم‌نام با کاربر جاری سیستم است\&.
.RE
.PP
\fIdescription\fR
.RS 4
توضیحی را برای انتساب به پایگاه‌داده جدید تعیین می‌کند\&.
.RE
.PP
\fB\-D \fR\fB\fItablespace\fR\fR
.br
\fB\-\-tablespace=\fR\fB\fItablespace\fR\fR
.RS 4
فضای جدول (tablespace) پیش‌فرض پایگاه‌داده را تعیین می‌کند\&. (این نام به‌عنوان یک شناسه نقل‌قول‌شده دوگانه پردازش می‌شود\&.)
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
دستوراتی را که
createdb
تولید کرده و به سرور ارسال می‌کند، در خروجی نمایش می‌دهد (echo)\&.
.RE
.PP
\fB\-E \fR\fB\fIencoding\fR\fR
.br
\fB\-\-encoding=\fR\fB\fIencoding\fR\fR
.RS 4
طرح کدگذاری نویسه‌ها (character encoding scheme) را برای استفاده در این پایگاه‌داده مشخص می‌کند\&. مجموعه‌های نویسه پشتیبانی‌شده توسط سرور
PostgreSQL
در بخش\ \&23.3.1 شرح داده شده‌اند\&.
.RE
.PP
\fB\-l \fR\fB\fIlocale\fR\fR
.br
\fB\-\-locale=\fR\fB\fIlocale\fR\fR
.RS 4
لوکال (locale) مورد استفاده در این پایگاه‌داده را مشخص می‌کند\&. این کار معادل تنظیم هم‌زمان گزینه‌های
\fB\-\-lc\-collate\fR،
\fB\-\-lc\-ctype\fR
و
\fB\-\-icu\-locale\fR
با مقداری یکسان است\&. برخی لوکال‌ها تنها برای ICU معتبر هستند و باید با
\fB\-\-icu\-locale\fR
تنظیم شوند\&.
.RE
.PP
\fB\-\-lc\-collate=\fR\fB\fIlocale\fR\fR
.RS 4
تنظیم LC_COLLATE را برای استفاده در این پایگاه‌داده مشخص می‌کند\&.
.RE
.PP
\fB\-\-lc\-ctype=\fR\fB\fIlocale\fR\fR
.RS 4
تنظیم LC_CTYPE را برای استفاده در این پایگاه‌داده مشخص می‌کند\&.
.RE
.PP
\fB\-\-builtin\-locale=\fR\fB\fIlocale\fR\fR
.RS 4
نام لوکال را هنگام استفاده از ارائه‌دهنده داخلی (builtin) مشخص می‌کند\&. پشتیبانی از لوکال در بخش\ \&23.1 شرح داده شده است\&.
.RE
.PP
\fB\-\-icu\-locale=\fR\fB\fIlocale\fR\fR
.RS 4
در صورت انتخاب ارائه‌دهنده لوکال ICU، شناسه لوکال ICU را برای استفاده در این پایگاه‌داده مشخص می‌کند\&.
.RE
.PP
\fB\-\-icu\-rules=\fR\fB\fIrules\fR\fR
.RS 4
قواعد تطبیق (collation rules) اضافی را برای سفارشی‌سازی رفتار تطبیق پیش‌فرض این پایگاه‌داده تعیین می‌کند\&. این مورد تنها برای ICU پشتیبانی می‌شود\&.
.RE
.PP
\fB\-\-locale\-provider={\fR\fBbuiltin\fR\fB|\fR\fBlibc\fR\fB|\fR\fBicu\fR\fB}\fR
.RS 4
ارائه‌دهنده لوکال را برای تطبیق پیش‌فرض پایگاه‌داده مشخص می‌کند\&.
.RE
.PP
\fB\-O \fR\fB\fIowner\fR\fR
.br
\fB\-\-owner=\fR\fB\fIowner\fR\fR
.RS 4
کاربر پایگاه‌داده‌ای را که مالک پایگاه‌داده جدید خواهد بود مشخص می‌کند\&. (این نام به‌عنوان یک شناسه نقل‌قول‌شده دوگانه پردازش می‌شود\&.)
.RE
.PP
\fB\-S \fR\fB\fIstrategy\fR\fR
.br
\fB\-\-strategy=\fR\fB\fIstrategy\fR\fR
.RS 4
راهبرد ساخت پایگاه‌داده را تعیین می‌کند\&. برای جزئیات بیشتر به
CREATE DATABASE STRATEGY
مراجعه کنید\&.
.RE
.PP
\fB\-T \fR\fB\fItemplate\fR\fR
.br
\fB\-\-template=\fR\fB\fItemplate\fR\fR
.RS 4
پایگاه‌داده الگویی را که این پایگاه‌داده باید بر مبنای آن ساخته شود مشخص می‌کند\&. (این نام به‌عنوان یک شناسه نقل‌قول‌شده دوگانه پردازش می‌شود\&.)
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
نسخه
createdb
را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
راهنمای آرگومان‌های خط فرمان
createdb
را نمایش داده و خارج می‌شود\&.
.RE
.PP
گزینه‌های
\fB\-D\fR،
\fB\-l\fR،
\fB\-E\fR،
\fB\-O\fR
و
\fB\-T\fR
متناظر با گزینه‌های دستور SQL زیربنایی
\fBCREATE DATABASE\fR
هستند؛ برای کسب اطلاعات بیشتر درباره آن‌ها به مستندات آن دستور مراجعه کنید\&.
.PP
دستور
createdb
همچنین آرگومان‌های خط فرمان زیر را برای پارامترهای اتصال می‌پذیرد:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
نام میزبان ماشینی را که سرور روی آن در حال اجراست مشخص می‌کند\&. اگر این مقدار با یک اسلش آغاز شود، به‌عنوان پوشه سوکت دامنه یونیکس (Unix domain socket) استفاده خواهد شد\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
پورت TCP یا پسوند فایل سوکت دامنه یونیکس محلی را که سرور برای دریافت اتصالات روی آن گوش می‌دهد مشخص می‌کند\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
نام کاربری برای برقراری اتصال\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
هرگز درخواست رمز عبور مطرح نمی‌کند\&. اگر سرور نیازمند احراز هویت با رمز عبور باشد و رمز عبور از راه‌های دیگری همچون فایل
\&.pgpass
در دسترس نباشد، تلاش برای برقراری اتصال با شکست مواجه می‌شود\&. این گزینه در کارهای دسته‌ای (batch jobs) و اسکریپت‌هایی که هیچ کاربری برای وارد کردن رمز عبور حضور ندارد مفید است\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
برنامه
createdb
را وادار می‌کند قبل از اتصال به پایگاه‌داده، درخواست رمز عبور کند\&.
.sp
این گزینه هرگز ضروری نیست، زیرا
createdb
در صورتی که سرور نیاز به احراز هویت با رمز عبور داشته باشد، به‌طور خودکار درخواست رمز عبور خواهد کرد\&. با این وجود،
createdb
یک تلاش برای اتصال را هدر خواهد داد تا متوجه شود سرور نیازمند رمز عبور است\&. در برخی موارد، مشخص کردن
\fB\-W\fR
برای جلوگیری از این تلاش مضاعف ارزشمند است\&.
.RE
.PP
\fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR
.RS 4
نام پایگاه‌داده‌ای را برای اتصال در حین ساخت پایگاه‌داده جدید مشخص می‌کند\&. در صورت عدم تعیین، از پایگاه‌داده
postgres
استفاده می‌شود؛ چنانچه آن پایگاه‌داده موجود نباشد (یا نام همان پایگاه‌داده جدیدی باشد که در حال ساخته شدن است)، از
template1
استفاده خواهد شد\&. این مقدار می‌تواند یک رشته اتصال (connection string) باشد\&. در این حالت، پارامترهای رشته اتصال بر هر گزینه خط فرمانی که دارای تضاد باشد ارجحیت خواهند داشت\&.
.RE
.SH "محیط (ENVIRONMENT)"
.PP
\fBPGDATABASE\fR
.RS 4
در صورت تنظیم، نام پایگاه‌داده‌ای را که باید ساخته شود مشخص می‌کند، مگر اینکه در خط فرمان بازنویسی شود\&.
.RE
.PP
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
پارامترهای اتصال پیش‌فرض\&.
\fBPGUSER\fR
همچنین در صورتی که نام پایگاه‌داده در خط فرمان یا از طریق
\fBPGDATABASE\fR
تعیین نشده باشد، نام پایگاه‌داده‌ای را که باید ساخته شود مشخص می‌کند\&.
.RE
.PP
\fBPG_COLOR\fR
.RS 4
مشخص می‌کند که آیا در پیام‌های خطا از رنگ استفاده شود یا خیر\&. مقادیر معتبر عبارتند از
always،
auto
و
never\&.
.RE
.PP
این ابزار، مانند اغلب ابزارهای دیگر
PostgreSQL،
از متغیرهای محیطی پشتیبانی‌شده توسط
libpq
نیز استفاده می‌کند (به بخش\ \&32.15 مراجعه فرمایید)\&.
.SH "خطاها (DIAGNOSTICS)"
.PP
در صورت بروز مشکل، برای بررسی مسائل احتمالی و پیام‌های خطا به
CREATE DATABASE (\fBCREATE_DATABASE\fR(7))
و
\fBpsql\fR(1)
مراجعه کنید\&. سرور پایگاه‌داده باید روی میزبان هدف در حال اجرا باشد\&. همچنین، هرگونه تنظیمات پیش‌فرض اتصال و متغیرهای محیطی مورد استفاده توسط کتابخانه پیشانه
libpq
اعمال خواهد شد\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
برای ساخت پایگاه‌داده
demo
با استفاده از سرور پایگاه‌داده پیش‌فرض:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreatedb demo\fR
.fi
.if n \{\
.RE
.\}
.PP
برای ساخت پایگاه‌داده
demo
روی میزبان
eden،
پورت 5000، با استفاده از پایگاه‌داده الگوی
template0،
دستور خط فرمان و دستور SQL زیربنایی مربوط به آن به شکل زیر است:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreatedb \-p 5000 \-h eden \-T template0 \-e demo\fR
CREATE DATABASE demo TEMPLATE template0;
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
\fBdropdb\fR(1), CREATE DATABASE (\fBCREATE_DATABASE\fR(7))