lowlydba.sqlserver.user 模块 – 配置数据库中的用户

注意

此模块是 lowlydba.sqlserver 集合 (版本 2.3.4) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install lowlydba.sqlserver。您需要其他要求才能使用此模块，有关详细信息，请参阅 需求。

要在剧本中使用它，请指定：lowlydba.sqlserver.user。

lowlydba.sqlserver 1.1.0 中的新增功能

概要

  • 创建、修改或删除数据库中的用户。

需求

执行此模块的主机需要以下需求。

参数

参数

注释

database

字符串 / 必需

用户的数据库。

default_schema

字符串

用户的默认数据库模式。

默认值： "dbo"

external_provider

布尔值

指定用户用于 Azure AD 身份验证。仅在创建新用户时使用，无法修改现有用户。

选项

  • false

  • true

login

字符串 / 必需

用户映射到的登录名称。

sql_instance

字符串 / 必需

要修改的 SQL Server 实例。

sql_password

字符串

SQL 身份验证的密码。

sql_username

字符串

SQL 身份验证的用户名。

state

字符串

对象是否应 present 或 absent。

选项

  • "present" ← (默认)

  • "absent"

username

字符串 / 必需

用户名。

属性

属性

支持

描述

check_mode

支持：完全支持

可以在 check_mode 下运行，并在不修改目标的情况下返回更改状态预测。

platform

平台： 所有

可以对其进行操作的目标操作系统/系列。

示例

- name: Create a user
  lowlydba.sqlserver.user:
    sql_instance: sql-01.myco.io
    login: TheIntern
    username: TheIntern
    database: InternProject1

- name: Change user's schema
  lowlydba.sqlserver.login:
    sql_instance: sql-01.myco.io
    login: TheIntern
    username: TheIntern
    database: InternProject1
    default_schema: dev

- name: Remove a user
  lowlydba.sqlserver.login:
    sql_instance: sql-01.myco.io
    login: TheIntern
    username: TheIntern
    database: InternProject1
    state: absent

返回值

常见的返回值已在此处记录 此处，以下是此模块特有的字段

键

描述

data

字典

New-DbaDbUser、Get-DbaDbUser 或 Remove-DbaDbUser 函数的输出。

返回：成功，但不在 check_mode 中。

作者

  • John McCall (@lowlydba)