Link Search Menu Expand Document

CREATE USER

Creates a new user.

For more information, see Managing users.

Syntax

CREATE USER [ IF NOT EXISTS ] <user_name>  
[ WITH 
[ LOGIN = <login_name> | SERVICE_ACCOUNT = <service_account> ]
[ DEFAULT_DATABASE = <database_name> ]
[ DEFAULT_ENGINE = <engine_name> ]
[ ROLE = <role_name>[,...<role_name>] ]
]

Parameters

Parameter Description
<user_name> The name of the user. The user name can be any string, and can also contain spaces and non-alpha-numeric characters such as exclamation points (!), percent signs (%), at signs(@), dot signs (.), underscore signs (_), minus signs (-), and asterisks (*). If the string contains spaces or non-alphanumeric characters, it must be enclosed in single or double quotes.
<login> An optional parameter to specify the name of the login to link the user with. This cannot be used in conjunction with the SERVICE_ACCOUNT parameter - a user can be linked to a login OR a service account but not both.
<service_account> An optional parameter to specify the name of the service account to link the user with. This cannot be used in conjunction with the LOGIN_NAME parameter - a user can be linked to a login OR a service account but not both.
<database_name> An optional parameter to define a default database for the user (for future purposes).
<engine_name> An optional parameter to define a default engine for the user (for future purposes).
<role> An optional parameter to define a role for the user. Additional roles can be granted after the user is created. If no role is specified, the user is granted no roles.

Example

The following command will create a user “alex” linked to the “alexs@acme.com”.

CREATE USER alex WITH LOGIN="alexs@acme.com";