{"Entry":{"collection":"sql","key":"create-user","name":"CREATE USER","aliases":["createuser"],"metadata":{"aliases":["createuser"],"changed_in":["7.0","7.2","7.4","8.0","8.1","9.0","9.1","9.5","9.6","10","11","19"],"changes":[{"from":"6.4","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":["description","usage"],"removed":[]},"status":"changed","synopsis":null,"to":"6.5"},{"from":"6.5","purpose_changed":true,"renamed":null,"sections":{"added":[],"changed":["description","usage"],"removed":[]},"status":"changed","synopsis":{"added":["[ SYSID uid ]","[ PASSWORD 'password' ] ]"],"removed":["[ WITH PASSWORD password ]"]},"to":"7.0"},{"from":"7.0","purpose_changed":false,"renamed":{"from_file":"sql-createuser.htm","to_file":"sql-createuser.html"},"sections":{"added":[],"changed":["description"],"removed":[]},"status":"changed","synopsis":null,"to":"7.1"},{"from":"7.1","purpose_changed":true,"renamed":null,"sections":{"added":[],"changed":["description","usage"],"removed":[]},"status":"changed","synopsis":{"added":["CREATE USER username [ [ WITH ] option [ ... ] ]","where option can be:","| [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'","| CREATEDB | NOCREATEDB","| CREATEUSER | NOCREATEUSER","| IN GROUP groupname [, ...]","| VALID UNTIL 'abstime'"],"removed":["[ PASSWORD 'password' ] ]","[ CREATEDB   | NOCREATEDB ] [ CREATEUSER | NOCREATEUSER ]","[ IN GROUP     groupname [, ...] ]","[ VALID UNTIL  'abstime' ]"]},"to":"7.2"},{"from":"7.2","purpose_changed":false,"renamed":null,"sections":{"added":["diagnostics","notes","examples","see_also"],"changed":["description","compatibility"],"removed":["usage"]},"status":"changed","synopsis":null,"to":"7.3"},{"from":"7.3","purpose_changed":false,"renamed":null,"sections":{"added":["parameters"],"changed":["description","notes","examples"],"removed":["diagnostics"]},"status":"changed","synopsis":{"added":["CREATE USER name [ [ WITH ] option [ ... ] ]"],"removed":["CREATE USER username [ [ WITH ] option [ ... ] ]"]},"to":"7.4"},{"from":"7.4","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":["parameters","notes"],"removed":[]},"status":"changed","synopsis":{"added":["| [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'","| VALID UNTIL 'abstime'"],"removed":["| [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'","| CREATEDB | NOCREATEDB"]},"to":"8.0"},{"from":"8.0","purpose_changed":true,"renamed":null,"sections":{"added":[],"changed":["description","see_also"],"removed":["parameters","notes","examples"]},"status":"changed","synopsis":{"added":["SUPERUSER | NOSUPERUSER","| CREATEROLE | NOCREATEROLE","| CREATEUSER | NOCREATEUSER","| INHERIT | NOINHERIT","| LOGIN | NOLOGIN","| CONNECTION LIMIT connlimit","| VALID UNTIL 'timestamp'","| IN ROLE rolename [, ...]","| IN GROUP rolename [, ...]","| ROLE rolename [, ...]","| ADMIN rolename [, ...]","| USER rolename [, ...]","| SYSID uid"],"removed":["SYSID uid","| IN GROUP groupname [, ...]","| VALID UNTIL 'abstime'"]},"to":"8.1"},{"from":"8.1","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":["description"],"removed":[]},"status":"changed","synopsis":null,"to":"8.2"},{"from":"8.4","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"changed","synopsis":{"added":["| IN ROLE role_name [, ...]","| IN GROUP role_name [, ...]","| ROLE role_name [, ...]","| ADMIN role_name [, ...]","| USER role_name [, ...]"],"removed":["where option can be:","| IN ROLE rolename [, ...]","| IN GROUP rolename [, ...]","| ROLE rolename [, ...]","| ADMIN rolename [, ...]","| USER rolename [, ...]"]},"to":"9.0"},{"from":"9.0","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"changed","synopsis":{"added":["| REPLICATION | NOREPLICATION"],"removed":[]},"to":"9.1"},{"from":"9.4","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"changed","synopsis":{"added":["| BYPASSRLS | NOBYPASSRLS"],"removed":[]},"to":"9.5"},{"from":"9.5","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"changed","synopsis":{"added":[],"removed":["| CREATEUSER | NOCREATEUSER"]},"to":"9.6"},{"from":"9.6","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"changed","synopsis":{"added":[],"removed":["| [ ENCRYPTED | UNENCRYPTED ] PASSWORD 'password'"]},"to":"10"},{"from":"10","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"changed","synopsis":{"added":["| [ ENCRYPTED ] PASSWORD 'password' | PASSWORD NULL"],"removed":[]},"to":"11"},{"from":"18","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"changed","synopsis":{"added":[],"removed":["| IN GROUP role_name [, ...]","| ROLE role_name [, ...]","| USER role_name [, ...]","| SYSID uid"]},"to":"19"}],"content_hash":"f30c82e90cd15b226088b6f8bd7fe76760c3371cf86d14f7309cb2b9c431828d","editorial":{},"first_version":"6.4","group":"role","imported_at":"2026-09-30T17:43:38.287573+08:00","last_version":"20","name":"CREATE USER","object":"USER","position":5017,"present_in":["6.4","6.5","7.0","7.1","7.2","7.3","7.4","8.0","8.1","8.2","8.3","8.4","9.0","9.1","9.2","9.3","9.4","9.5","9.6","10","11","12","13","14","15","16","17","18","19","20"],"purpose":"define a new database role","purpose_zh":"","related":["create-role"],"slug":"create-user","source_rev":"a709ab85","synopsis":"CREATE USER name [ [ WITH ] option [ ... ] ]\n\nwhere option can be:\n\nSUPERUSER | NOSUPERUSER\n| CREATEDB | NOCREATEDB\n| CREATEROLE | NOCREATEROLE\n| INHERIT | NOINHERIT\n| LOGIN | NOLOGIN\n| REPLICATION | NOREPLICATION\n| BYPASSRLS | NOBYPASSRLS\n| CONNECTION LIMIT connlimit\n| [ ENCRYPTED ] PASSWORD 'password' | PASSWORD NULL\n| VALID UNTIL 'timestamp'\n| IN ROLE role_name [, ...]\n| ROLE role_name [, ...]\n| ADMIN role_name [, ...]\n| SYSID uid","verb":"CREATE"}},"Definition":{"Collection":"sql","Key":"create-user","SourceDatabase":"center","Version":"18","SourceTable":"sqlcmd","SourceKey":"create-user","SourceRevision":"a709ab85","Facts":{"anchor":"SQL-CREATEUSER","file":"sql-createuser.html","lang":"en","name":"CREATE USER","purpose":"define a new database role","purpose_zh":"","related":["create-role"],"sections":[{"html":"\u003cp\u003e\u003ccode class=\"command\"\u003eCREATE USER\u003c/code\u003e is now an alias for \u003ca href=\"/docs/18/sql-createrole.html\" title=\"CREATE ROLE\"\u003e\u003ccode class=\"command\"\u003eCREATE ROLE\u003c/code\u003e\u003c/a\u003e. The only difference is that when the command is spelled \u003ccode class=\"command\"\u003eCREATE USER\u003c/code\u003e, \u003ccode class=\"literal\"\u003eLOGIN\u003c/code\u003e is assumed by default, whereas \u003ccode class=\"literal\"\u003eNOLOGIN\u003c/code\u003e is assumed when the command is spelled \u003ccode class=\"command\"\u003eCREATE ROLE\u003c/code\u003e.\u003c/p\u003e","key":"description","title":"Description"},{"html":"\u003cp\u003eThe \u003ccode class=\"command\"\u003eCREATE USER\u003c/code\u003e statement is a \u003cspan class=\"productname\"\u003ePostgreSQL\u003c/span\u003e extension. The SQL standard leaves the definition of users to the implementation.\u003c/p\u003e","key":"compatibility","title":"Compatibility"},{"html":"\u003cspan class=\"simplelist\"\u003e\u003ca href=\"/wiki/sql/create-role/?v=18\" title=\"CREATE ROLE\"\u003e\u003cspan class=\"refentrytitle\"\u003eCREATE ROLE\u003c/span\u003e\u003c/a\u003e\u003c/span\u003e","key":"see_also","title":"See Also"}],"sections_same_as":"","slug":"18","synopsis_html":"CREATE USER \u003cem class=\"replaceable\"\u003e\u003ccode\u003ename\u003c/code\u003e\u003c/em\u003e [ [ WITH ] \u003cem class=\"replaceable\"\u003e\u003ccode\u003eoption\u003c/code\u003e\u003c/em\u003e [ ... ] ]\n\n\u003cspan class=\"phrase\"\u003ewhere \u003cem class=\"replaceable\"\u003e\u003ccode\u003eoption\u003c/code\u003e\u003c/em\u003e can be:\u003c/span\u003e\n\n      SUPERUSER | NOSUPERUSER\n    | CREATEDB | NOCREATEDB\n    | CREATEROLE | NOCREATEROLE\n    | INHERIT | NOINHERIT\n    | LOGIN | NOLOGIN\n    | REPLICATION | NOREPLICATION\n    | BYPASSRLS | NOBYPASSRLS\n    | CONNECTION LIMIT \u003cem class=\"replaceable\"\u003e\u003ccode\u003econnlimit\u003c/code\u003e\u003c/em\u003e\n    | [ ENCRYPTED ] PASSWORD '\u003cem class=\"replaceable\"\u003e\u003ccode\u003epassword\u003c/code\u003e\u003c/em\u003e' | PASSWORD NULL\n    | VALID UNTIL '\u003cem class=\"replaceable\"\u003e\u003ccode\u003etimestamp\u003c/code\u003e\u003c/em\u003e'\n    | IN ROLE \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | IN GROUP \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | ROLE \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | ADMIN \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | USER \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | SYSID \u003cem class=\"replaceable\"\u003e\u003ccode\u003euid\u003c/code\u003e\u003c/em\u003e","synopsis_text":"CREATE USER name [ [ WITH ] option [ ... ] ]\n\nwhere option can be:\n\nSUPERUSER | NOSUPERUSER\n| CREATEDB | NOCREATEDB\n| CREATEROLE | NOCREATEROLE\n| INHERIT | NOINHERIT\n| LOGIN | NOLOGIN\n| REPLICATION | NOREPLICATION\n| BYPASSRLS | NOBYPASSRLS\n| CONNECTION LIMIT connlimit\n| [ ENCRYPTED ] PASSWORD 'password' | PASSWORD NULL\n| VALID UNTIL 'timestamp'\n| IN ROLE role_name [, ...]\n| IN GROUP role_name [, ...]\n| ROLE role_name [, ...]\n| ADMIN role_name [, ...]\n| USER role_name [, ...]\n| SYSID uid"},"ManualEvidence":{},"MeasuredEvidence":{}},"Text":{"Collection":"sql","Key":"create-user","SourceDatabase":"pgweb","Version":"18","Locale":"zh-Hans","Title":"CREATE USER","Summary":"定义一个新的数据库角色","BodyHTML":"\u003cpre\u003eCREATE USER name [ [ WITH ] option [ ... ] ]\n\n其中 option 可以是：\n\nSUPERUSER | NOSUPERUSER\n| CREATEDB | NOCREATEDB\n| CREATEROLE | NOCREATEROLE\n| INHERIT | NOINHERIT\n| LOGIN | NOLOGIN\n| REPLICATION | NOREPLICATION\n| BYPASSRLS | NOBYPASSRLS\n| CONNECTION LIMIT connlimit\n| [ ENCRYPTED ] PASSWORD \u0026#39;password\u0026#39; | PASSWORD NULL\n| VALID UNTIL \u0026#39;timestamp\u0026#39;\n| IN ROLE role_name [, ...]\n| IN GROUP role_name [, ...]\n| ROLE role_name [, ...]\n| ADMIN role_name [, ...]\n| USER role_name [, ...]\n| SYSID uid\u003c/pre\u003e\u003csection\u003e\u003ch2\u003e描述\u003c/h2\u003e\u003cp\u003e\u003ccode\u003eCREATE USER\u003c/code\u003e现为 \u003ca href=\"/docs/18/sql-createrole.html\" title=\"CREATE ROLE\" rel=\"nofollow\"\u003e\u003ccode\u003eCREATE ROLE\u003c/code\u003e\u003c/a\u003e的别名。唯一的区别在于：当命令写为\u003ccode\u003eCREATE USER\u003c/code\u003e时，默认假定为\u003ccode\u003eLOGIN\u003c/code\u003e；而当命令写为 \u003ccode\u003eCREATE ROLE\u003c/code\u003e时，默认假定为\u003ccode\u003eNOLOGIN\u003c/code\u003e。\u003c/p\u003e\u003c/section\u003e\u003csection\u003e\u003ch2\u003e兼容性\u003c/h2\u003e\u003cp\u003e\u003ccode\u003eCREATE USER\u003c/code\u003e语句是 \u003cspan\u003ePostgreSQL\u003c/span\u003e的一种扩展。SQL 标准将用户的定义留给具体实现决定。\u003c/p\u003e\u003c/section\u003e\u003csection\u003e\u003ch2\u003e另见\u003c/h2\u003e\u003cspan\u003e\u003ca href=\"/wiki/sql/create-role/?v=18\" title=\"CREATE ROLE\" rel=\"nofollow\"\u003e\u003cspan\u003eCREATE ROLE\u003c/span\u003e\u003c/a\u003e\u003c/span\u003e\u003c/section\u003e","SourceRevision":"1b5ca64c","ContentHash":"8862c32f9a6272a40371d97b0f961b48d94475dd33f0cce13b17681c64b11375","Payload":{"purpose_zh":"定义一个新的数据库角色","sections":[{"html":"\u003cp\u003e\u003ccode class=\"command\"\u003eCREATE USER\u003c/code\u003e现为 \u003ca href=\"/docs/18/sql-createrole.html\" title=\"CREATE ROLE\"\u003e\u003ccode class=\"command\"\u003eCREATE ROLE\u003c/code\u003e\u003c/a\u003e的别名。唯一的区别在于：当命令写为\u003ccode class=\"command\"\u003eCREATE USER\u003c/code\u003e时，默认假定为\u003ccode class=\"literal\"\u003eLOGIN\u003c/code\u003e；而当命令写为 \u003ccode class=\"command\"\u003eCREATE ROLE\u003c/code\u003e时，默认假定为\u003ccode class=\"literal\"\u003eNOLOGIN\u003c/code\u003e。\u003c/p\u003e","key":"description","title":"描述"},{"html":"\u003cp\u003e\u003ccode class=\"command\"\u003eCREATE USER\u003c/code\u003e语句是 \u003cspan class=\"productname\"\u003ePostgreSQL\u003c/span\u003e的一种扩展。SQL 标准将用户的定义留给具体实现决定。\u003c/p\u003e","key":"compatibility","title":"兼容性"},{"html":"\u003cspan class=\"simplelist\"\u003e\u003ca href=\"/wiki/sql/create-role/?v=18\" title=\"CREATE ROLE\"\u003e\u003cspan class=\"refentrytitle\"\u003eCREATE ROLE\u003c/span\u003e\u003c/a\u003e\u003c/span\u003e","key":"see_also","title":"另见"}],"sections_same_as":"","synopsis_html":"CREATE USER \u003cem class=\"replaceable\"\u003e\u003ccode\u003ename\u003c/code\u003e\u003c/em\u003e [ [ WITH ] \u003cem class=\"replaceable\"\u003e\u003ccode\u003eoption\u003c/code\u003e\u003c/em\u003e [ ... ] ]\n\n\u003cspan class=\"phrase\"\u003e其中 \u003cem class=\"replaceable\"\u003e\u003ccode\u003eoption\u003c/code\u003e\u003c/em\u003e 可以是：\u003c/span\u003e\n\n      SUPERUSER | NOSUPERUSER\n    | CREATEDB | NOCREATEDB\n    | CREATEROLE | NOCREATEROLE\n    | INHERIT | NOINHERIT\n    | LOGIN | NOLOGIN\n    | REPLICATION | NOREPLICATION\n    | BYPASSRLS | NOBYPASSRLS\n    | CONNECTION LIMIT \u003cem class=\"replaceable\"\u003e\u003ccode\u003econnlimit\u003c/code\u003e\u003c/em\u003e\n    | [ ENCRYPTED ] PASSWORD '\u003cem class=\"replaceable\"\u003e\u003ccode\u003epassword\u003c/code\u003e\u003c/em\u003e' | PASSWORD NULL\n    | VALID UNTIL '\u003cem class=\"replaceable\"\u003e\u003ccode\u003etimestamp\u003c/code\u003e\u003c/em\u003e'\n    | IN ROLE \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | IN GROUP \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | ROLE \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | ADMIN \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | USER \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e [, ...]\n    | SYSID \u003cem class=\"replaceable\"\u003e\u003ccode\u003euid\u003c/code\u003e\u003c/em\u003e","synopsis_text":"CREATE USER name [ [ WITH ] option [ ... ] ]\n\n其中 option 可以是：\n\nSUPERUSER | NOSUPERUSER\n| CREATEDB | NOCREATEDB\n| CREATEROLE | NOCREATEROLE\n| INHERIT | NOINHERIT\n| LOGIN | NOLOGIN\n| REPLICATION | NOREPLICATION\n| BYPASSRLS | NOBYPASSRLS\n| CONNECTION LIMIT connlimit\n| [ ENCRYPTED ] PASSWORD 'password' | PASSWORD NULL\n| VALID UNTIL 'timestamp'\n| IN ROLE role_name [, ...]\n| IN GROUP role_name [, ...]\n| ROLE role_name [, ...]\n| ADMIN role_name [, ...]\n| USER role_name [, ...]\n| SYSID uid"}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["10","11","12","13","14","15","16","17","18","19","20","6.4","6.5","7.0","7.1","7.2","7.3","7.4","8.0","8.1","8.2","8.3","8.4","9.0","9.1","9.2","9.3","9.4","9.5","9.6"],"Locales":["en","zh-Hans"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}