.\" auto-generated by docbook2man-spec $Revision: 1.1 $
.TH "GRANT" "7" "2003-11-02" "SQL - Language Statements" "SQL Commands"
.SH NAME
GRANT \- 定義訪問許可權

.SH SYNOPSIS
.sp
.nf
GRANT { { SELECT | INSERT | UPDATE | DELETE | RULE | REFERENCES | TRIGGER }
    [,...] | ALL [ PRIVILEGES ] }
    ON [ TABLE ] \fItablename\fR [, ...]
    TO { \fIusername\fR | GROUP \fIgroupname\fR | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { { CREATE | TEMPORARY | TEMP } [,...] | ALL [ PRIVILEGES ] }
    ON DATABASE \fIdbname\fR [, ...]
    TO { \fIusername\fR | GROUP \fIgroupname\fR | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { EXECUTE | ALL [ PRIVILEGES ] }
    ON FUNCTION \fIfuncname\fR ([\fItype\fR, ...]) [, ...]
    TO { \fIusername\fR | GROUP \fIgroupname\fR | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { USAGE | ALL [ PRIVILEGES ] }
    ON LANGUAGE \fIlangname\fR [, ...]
    TO { \fIusername\fR | GROUP \fIgroupname\fR | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { { CREATE | USAGE } [,...] | ALL [ PRIVILEGES ] }
    ON SCHEMA \fIschemaname\fR [, ...]
    TO { \fIusername\fR | GROUP \fIgroupname\fR | PUBLIC } [, ...] [ WITH GRANT OPTION ]
.sp
.fi
.SH "DESCRIPTION 描述"
.PP
\fBGRANT\fR 命令將某物件（表，檢視，序列，函式過程語言，或者模式） 上的特定許可權給予一個使用者或者多個使用者或者一組使用者。 這些許可權將增加到那些已經賦予的許可權上，如果存在這些許可權的話。
.PP
 鍵字 PUBLIC 表示該許可權要賦予所有使用者, 包括那些以後可能建立的使用者。PUBLIC  可以看做是一個隱含定義好的組，它總是包括所有使用者。 任何特定的使用者都將擁有直接賦予他/她的許可權，加上他/她所處的任何組， 以及再加上賦予 PUBLIC 的許可權的總和。
.PP
 如果聲明瞭 WITH GRANT OPTION，那麼許可權的受予者也可以賦予別人。 預設的時候這是不允許的。賦權選項只能給獨立的使用者，而不能給組或者 PUBLIC。
.PP
 對物件的所有者（通常就是建立者）而言，沒有什麼許可權需要賦予， 因為所有者預設就持有所有許可權。（不過，所有者出於安全考慮可以選擇廢棄一些他自己的許可權。） 刪除一個物件的權力，或者是任意修改它的權力都不是可賦予的權利所能描述的； 它是建立者固有的，並且不能賦予或撤銷。
.PP
 根據物件的不同，初始的預設許可權可能包括給 PUBLIC  賦予一些許可權。預設設定對於表和模式是沒有公開訪問許可權的； TEMP 表為資料庫建立許可權；EXECUTE 許可權用於函式； 以及 USAGE 用於語言。物件所有者當然可以撤回這些許可權。 （出於最大安全性考慮，在建立該物件的同一個事務中發出 REVOKE； 那麼就不會開啟給別的使用者使用該物件的視窗。）
.PP
 可能的許可權有：
.TP
\fBSELECT\fR
 允許對宣告的表，試圖，或者序列 SELECT [\fBselect\fR(7)] 任意欄位。還允許做
COPY [\fBcopy\fR(7)] TO 的源。 對於序列而言，這個許可權還允許使用 currval 函式。
.TP
\fBINSERT\fR
 允許向宣告的表 INSERT [\fBinsert\fR(7)] 一個新行。 同時還允許做 COPY [\fBcopy\fR(7)] FROM。
.TP
\fBUPDATE\fR
 允許對宣告的表中任意欄位做 UPDATE [\fBupdate\fR(7)] 。 SELECT ... FOR UPDATE 也要求這個許可權 （除了 SELECT 許可權之外）。比如， 這個許可權允許使用nextval 和 setval。
.TP
\fBDELETE\fR
 允許從宣告的表中 DELETE [\fBdelete\fR(7)] 行。
.TP
\fBRULE\fR
 允許在該表/檢視上建立規則。（參閱 CREATE RULE [\fBcreate_rule\fR(7)] 語句。）
.TP
\fBREFERENCES\fR
 要建立一個外來鍵約束，你必須在參考表和被參考表上都擁有這個許可權。
.TP
\fBTRIGGER\fR
 允許在宣告表上建立觸發器。（參閱
CREATE TRIGGER [\fBcreate_trigger\fR(7)] 語句。）
.TP
\fBCREATE\fR
 對於資料庫，允許在該資料庫裡建立新的模式。

 對於模式，允許在該模式中建立新的物件。 要重新命名一個現有物件，你必需擁有該物件並且。 對包含該物件的模式擁有這個許可權。
.TP
\fBTEMPORARY\fR
.TP
\fBTEMP\fR
 允許在使用該資料庫的時候建立臨時表。
.TP
\fBEXECUTE\fR
 允許使用指定的函式並且可以使用任何利用這些函式實現的運算子。 這是適用於函式的唯一的一種許可權型別。 （該語法同樣適用於聚集函式。）
.TP
\fBUSAGE\fR
 對於過程語言， 允許使用指定過程語言建立該語言的函式。 這是適用於過程語言的唯一的一種許可權型別。

 對於模式，允許訪問包含在指定模式中的物件（假設該物件的所有權要求同樣也設定了）。 最終這些就允許了許可權接受者"查詢"模式中的物件。
.TP
\fBALL PRIVILEGES\fR
 一次性給予所有適用於該物件的許可權。 PRIVILEGES 關鍵字在 PostgreSQL 裡是可選的， 但是嚴格的 SQL 要求有這個關鍵字。
.PP
 其它命令要求的許可權都在相應的命令的參考頁上列出。
.SH "NOTES 注意"
.PP
REVOKE [\fBrevoke\fR(7)] 命令用於刪除訪問許可權。
.PP
 我們要注意資料庫超級使用者可以訪問所有物件， 而不會受物件的許可權設定影響。這個特點類似 Unix 系統的 root  的許可權。和 root 一樣，除了必要的情況，總是以超級使用者身分進行操作是不明智的做法。
.PP
If a superuser chooses to issue a \fBGRANT\fR or \fBREVOKE\fR
command, the command is performed as though it were issued by the
owner of the affected object. In particular, privileges granted via
such a command will appear to have been granted by the object owner.
.PP
 目前，要在 PostgreSQL 裡只對某幾列賦予許可權， 你必須建立一個擁有那幾行的檢視然後給那個檢視賦予許可權。
.PP
 使用 \fBpsql\fR(1) 的 \fB\\z\fR 命令獲取在現有物件上的與許可權有關的資訊。
.sp
.nf
=> \\z mytable

        Access privileges for database "lusitania"
 Schema |  Table  |           Access privileges
--------+---------+---------------------------------------
 public | mytable | {=r/postgres,miriam=arwdRxt/postgres,"group todos=arw/postgres"}
(1 row)
.sp
.fi
\fB\\z\fR 顯示的條目解釋如下：
.sp
.nf
              =xxxx -- 賦予 PUBLIC 的許可權
         uname=xxxx -- 賦予一個使用者的許可權
   group gname=xxxx -- 賦予一個組的許可權

                  r -- SELECT ("讀")
                  w -- UPDATE ("寫")
                  a -- INSERT ("追加")
                  d -- DELETE
                  R -- RULE
                  x -- REFERENCES
                  t -- TRIGGER
                  X -- EXECUTE
                  U -- USAGE
                  C -- CREATE
                  T -- TEMPORARY
            arwdRxt -- ALL PRIVILEGES (for tables)
                  * -- 給前面許可權的授權選項

              /yyyy -- 授出這個許可權的使用者
.sp
.fi
 使用者 miriam 在建完表之後再做下面的語句， 就可以得到上面例子的結果
.sp
.nf
GRANT SELECT ON mytable TO PUBLIC;
GRANT SELECT, UPDATE, INSERT ON mytable TO GROUP todos;
.sp
.fi
.PP
 如果一個給定的物件的 "Access privileges" 欄位是空的， 這意味著該物件有預設許可權（也就是說，它的許可權欄位是 NULL）。 預設許可權總是包括所有者的所有許可權，以及根據物件的不同，可能包含一些給 PUBLIC  的許可權。 物件上第一個 GRANT 或者 REVOKE  將例項化這個預設許可權（比如，產生 {=,miriam=arwdRxt}） 然後根據每次特定的需求修改它。
.SH "EXAMPLES 例子"
.PP
 把表 films 的插入許可權賦予所有使用者：
.sp
.nf
GRANT INSERT ON films TO PUBLIC;
.sp
.fi
.PP
 賦予使用者manuel對檢視kinds的所有許可權：
.sp
.nf
GRANT ALL PRIVILEGES ON kinds TO manuel;
.sp
.fi
.SH "COMPATIBILITY 相容性"
.PP
 根據 SQL 標準，在 ALL PRIVILEGES 裡的 PRIVILEGES  關鍵字是必須的。SQL 不支援在一條命令裡對多個表設定許可權。
.PP
SQL 標準允許在一個表裡為獨立的欄位設定許可權：
.sp
.nf
GRANT \fIprivileges\fR
    ON \fItable\fR [ ( \fIcolumn\fR [, ...] ) ] [, ...]
    TO { PUBLIC | \fIusername\fR [, ...] } [ WITH GRANT OPTION ]
.sp
.fi
.PP
SQL 標準對其它型別的物件提供了一個 USAGE 許可權：字符集，校勘，轉換，域。
.PP
RULE 許可權，以及在資料庫，模式，語言和序列上的許可權是 PostgreSQL 擴充套件。
.SH "SEE ALSO 參見"
.PP
REVOKE [\fBrevoke\fR(7)]
.SH "譯者"
.B Postgresql 中文網站
.B 何偉平 <laser@pgsqldb.org>
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR