initdb - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

initdb - tạo một cụm cơ sở dữ liệu PostgreSQL mới

SYNOPSIS

initdb [tùy chọn...] [--pgdata | -D] thư mục

MÔ TẢ

initdb tạo một cụm cơ sở dữ liệu PostgreSQL mới. Một cụm cơ sở dữ liệu là một tập hợp của
cơ sở dữ liệu được quản lý bởi một phiên bản máy chủ duy nhất.

Tạo một cụm cơ sở dữ liệu bao gồm việc tạo các thư mục trong đó cơ sở dữ liệu
dữ liệu sẽ tồn tại, tạo ra các bảng danh mục được chia sẻ (các bảng thuộc về toàn bộ
thay vì vào bất kỳ cơ sở dữ liệu cụ thể nào) và tạo template1 và postgres
cơ sở dữ liệu. Sau này khi bạn tạo cơ sở dữ liệu mới, mọi thứ trong cơ sở dữ liệu template1 sẽ
đã sao chép. (Do đó, mọi thứ được cài đặt trong template1 đều được tự động sao chép vào từng
cơ sở dữ liệu được tạo sau.) Cơ sở dữ liệu postgres là cơ sở dữ liệu mặc định được sử dụng bởi
người dùng, tiện ích và ứng dụng của bên thứ ba.

Mặc dù initdb sẽ cố gắng tạo thư mục dữ liệu được chỉ định, nó có thể không có
quyền nếu thư mục mẹ của thư mục dữ liệu mong muốn thuộc sở hữu của người gốc. Đến
khởi tạo trong một thiết lập như vậy, tạo một thư mục dữ liệu trống làm thư mục gốc, sau đó sử dụng chown đến
gán quyền sở hữu thư mục đó cho tài khoản người dùng cơ sở dữ liệu, sau đó su trở thành
người dùng cơ sở dữ liệu để chạy initdb.

initdb phải được chạy với tư cách là người dùng sẽ sở hữu quy trình máy chủ, vì máy chủ cần
để có quyền truy cập vào các tệp và thư mục initdb tạo ra. Vì máy chủ không thể
được chạy dưới dạng root, bạn không được chạy initdb cũng như gốc. (Trên thực tế, nó sẽ từ chối làm như vậy.)

initdb khởi tạo mã hóa bộ ký tự và ngôn ngữ mặc định của cụm cơ sở dữ liệu. Các
mã hóa bộ ký tự, thứ tự đối chiếu (LC_COLLATE) và các lớp bộ ký tự (LC_CTYPE,
ví dụ: chữ trên, chữ thường, chữ số) có thể được đặt riêng cho cơ sở dữ liệu khi nó được tạo. initdb
xác định các cài đặt đó cho cơ sở dữ liệu template1, cơ sở dữ liệu này sẽ đóng vai trò là cài đặt mặc định cho
tất cả các cơ sở dữ liệu khác.

Để thay đổi thứ tự đối chiếu mặc định hoặc các lớp bộ ký tự, hãy sử dụng --lc-đối chiếu và
--lc-ctype tùy chọn. Các lệnh đối chiếu không phải C hoặc POSIX cũng có hiệu suất
hình phạt. Vì những lý do này, điều quan trọng là phải chọn đúng ngôn ngữ khi chạy initdb.

Các danh mục ngôn ngữ còn lại có thể được thay đổi sau khi máy chủ được khởi động. Bạn có thể
cũng sử dụng --ngôn ngữ để đặt mặc định cho tất cả các danh mục ngôn ngữ, bao gồm cả thứ tự đối chiếu
và các lớp đặt ký tự. Tất cả các giá trị ngôn ngữ máy chủ (lc_ *) có thể được hiển thị qua HIỂN THỊ TẤT CẢ CÁC.
Bạn có thể tìm thêm chi tiết trong Phần 22.1, “Hỗ trợ ngôn ngữ”, trong tài liệu.

Để thay đổi mã hóa mặc định, hãy sử dụng - mã hóa. Thông tin chi tiết có thể được tìm thấy trong Phần
22.3, “Hỗ trợ bộ ký tự”, trong tài liệu.

LỰA CHỌN

-A phương thức xác thực
--auth =phương thức xác thực
Tùy chọn này chỉ định phương thức xác thực cho người dùng cục bộ được sử dụng trong pg_hba.conf
(máy chủ và đường nội bộ). Không sử dụng tin cậy trừ khi bạn tin tưởng tất cả người dùng địa phương trên
hệ thống. tin cậy là mặc định để dễ cài đặt.

--auth-host =phương thức xác thực
Tùy chọn này chỉ định phương thức xác thực cho người dùng cục bộ thông qua kết nối TCP / IP
được sử dụng trong pg_hba.conf (dòng máy chủ).

--auth-local =phương thức xác thực
Tùy chọn này chỉ định phương thức xác thực cho người dùng cục bộ thông qua ổ cắm miền Unix
kết nối được sử dụng trong pg_hba.conf (đường cục bộ).

-D thư mục
--pgdata =thư mục
Tùy chọn này chỉ định thư mục nơi cụm cơ sở dữ liệu sẽ được lưu trữ. Cái này
là thông tin duy nhất được yêu cầu bởi initdb, nhưng bạn có thể tránh viết nó bằng cách đặt
các PGDATA biến môi trường, có thể thuận tiện vì máy chủ cơ sở dữ liệu
(bưu điện) có thể tìm thấy thư mục cơ sở dữ liệu sau đó bằng cùng một biến.

-E mã hóa
--encoding =mã hóa
Chọn mã hóa của cơ sở dữ liệu mẫu. Đây cũng sẽ là mã hóa mặc định
của bất kỳ cơ sở dữ liệu nào bạn tạo sau này, trừ khi bạn ghi đè nó ở đó. Mặc định là bắt nguồn
từ ngôn ngữ hoặc SQL_ASCII nếu điều đó không hoạt động. Các bộ ký tự được hỗ trợ bởi
máy chủ PostgreSQL được mô tả trong Phần 22.3.1, “Bộ ký tự được hỗ trợ”, trong
tài liệu.

-k
- tổng kiểm tra dữ liệu
Sử dụng tổng kiểm tra trên các trang dữ liệu để giúp phát hiện tham nhũng bởi hệ thống I / O sẽ
nếu không thì hãy im lặng. Kích hoạt tổng kiểm tra có thể phải chịu một hình phạt hiệu suất đáng chú ý.
Tùy chọn này chỉ có thể được đặt trong quá trình khởi tạo và không thể thay đổi sau này. Nếu như
set, tổng kiểm tra được tính cho tất cả các đối tượng, trong tất cả các cơ sở dữ liệu.

--locale =miền địa phương
Đặt ngôn ngữ mặc định cho cụm cơ sở dữ liệu. Nếu tùy chọn này không được chỉ định,
ngôn ngữ được kế thừa từ môi trường initdb chạy trong. Hỗ trợ ngôn ngữ là
được mô tả trong Phần 22.1, “Hỗ trợ ngôn ngữ”, trong tài liệu.

--lc-collate =miền địa phương
--lc-ctype =miền địa phương
--lc-messages =miền địa phương
--lc-money =miền địa phương
--lc-numeric =miền địa phương
--lc-time =miền địa phương
Như --ngôn ngữ, nhưng chỉ đặt ngôn ngữ trong danh mục được chỉ định.

- không có ngôn ngữ
Tương đương với --locale = C.

-N
--nosync
Theo mặc định, initdb sẽ đợi tất cả các tệp được ghi một cách an toàn vào đĩa. Tùy chọn này
nguyên nhân initdb để quay lại mà không cần chờ đợi, nhanh hơn, nhưng có nghĩa là
sự cố hệ điều hành có thể làm hỏng thư mục dữ liệu. Nói chung, tùy chọn này là
hữu ích để thử nghiệm, nhưng không nên được sử dụng khi tạo cài đặt sản xuất.

--pwfile =tên tập tin
Làm cho initdb đọc mật khẩu của superuser cơ sở dữ liệu từ một tệp. Dòng đầu tiên của
tệp được lấy làm mật khẩu.

-S
--chỉ đồng bộ
Ghi tất cả các tệp cơ sở dữ liệu vào đĩa và thoát một cách an toàn. Điều này không thực hiện bất kỳ
hoạt động initdb bình thường.

-T CFG
--text-search-config =CFG
Đặt cấu hình tìm kiếm văn bản mặc định. Xem default_text_search_config để biết thêm
thông tin.

-U tên truy nhập
- tên người dùng =tên truy nhập
Chọn tên người dùng của siêu người dùng cơ sở dữ liệu. Điều này mặc định là tên của
người dùng hiệu quả đang chạy initdb. Nó thực sự không quan trọng tên của superuser
là, nhưng người ta có thể chọn giữ tên thông thường postgres, ngay cả khi hoạt động
tên người dùng hệ thống khác nhau.

-W
--pwprompt
Làm cho initdb nhắc nhập mật khẩu để cấp cho siêu người dùng cơ sở dữ liệu. Nếu bạn không có kế hoạch
về việc sử dụng xác thực mật khẩu, điều này không quan trọng. Nếu không bạn sẽ không thể
để sử dụng xác thực mật khẩu cho đến khi bạn thiết lập mật khẩu.

-X thư mục
--xlogdir =thư mục
Tùy chọn này chỉ định thư mục nơi nhật ký giao dịch sẽ được lưu trữ.

Các tùy chọn khác, ít được sử dụng hơn, cũng có sẵn:

-d
--gỡ lỗi
In đầu ra gỡ lỗi từ chương trình phụ trợ bootstrap và một vài thông báo khác nhỏ hơn
lợi ích cho công chúng. Phần phụ trợ bootstrap là chương trình initdb sử dụng để
tạo các bảng danh mục. Tùy chọn này tạo ra một lượng lớn cực kỳ
đầu ra nhàm chán.

-L thư mục
Chỉ định nơi initdb nên tìm các tệp đầu vào của nó để khởi tạo cụm cơ sở dữ liệu.
Điều này thường không cần thiết. Bạn sẽ được thông báo nếu bạn cần chỉ định vị trí của họ
một cách rõ ràng.

-n
--noclean
Theo mặc định, khi initdb xác định rằng một lỗi đã ngăn nó hoàn toàn tạo ra
cụm cơ sở dữ liệu, nó xóa bất kỳ tệp nào nó có thể đã tạo trước khi khám phá
rằng nó không thể hoàn thành công việc. Tùy chọn này hạn chế việc thu dọn và do đó rất hữu ích cho
gỡ lỗi.

Các lựa chọn khác:

-V
--phiên bản
In phiên bản initdb và thoát.

-?
--Cứu giúp
Hiển thị trợ giúp về các đối số dòng lệnh initdb và thoát.

MÔI TRƯỜNG

PGDATA
Chỉ định thư mục nơi cụm cơ sở dữ liệu sẽ được lưu trữ; có thể bị ghi đè
bằng cách sử dụng -D tùy chọn.

TZ
Chỉ định múi giờ mặc định của cụm cơ sở dữ liệu đã tạo. Giá trị phải là
tên múi giờ đầy đủ (xem Phần 8.5.3, “Múi giờ”, trong tài liệu).

Tiện ích này, giống như hầu hết các tiện ích PostgreSQL khác, cũng sử dụng các biến môi trường
được hỗ trợ bởi libpq (xem Phần 31.14, “Biến môi trường”, trong tài liệu).

GHI CHÚ

initdb cũng có thể được gọi qua pg_ctl initdb.

Sử dụng initdb trực tuyến bằng các dịch vụ onworks.net