MisakaSora: half translated

2019-09-20T10:05:02Z

half translated

New page

{{Languages|SQL Admins (SourceMod)}}
__FORCETOC__

SourceMod已经支持通过SQL来加载管理admin，现在支持是数据库是MySQL和SQLite。如果你有大量管理员、你想通过外部工具管理或者你想在不同服务器中共享管理员，使用数据库是非常有效的。

本文会介绍如何配置服务器来使用SQL管理admin。基础管理不需要SQL知识，但是使用这个功能，你必须意识到SourceMod并不会为完整的SQL控制提供简单的功能。如果你需要更好的功能，你需要使用三方工具或者自学SQL。

不过，先假设你会:
*能访问一个数据库，
*明白如何访问一个数据库;
*明白如何在数据库中执行指令或者脚本。

=配置=
==MySQL==
打开服务器的<tt>configs/databases.cfg</tt>文件，你应该会看到有一个叫<tt>"default"</tt>的节点。你可以使用这个，如果你想分开连接也可以创建一个新的<tt>"admins"</tt>节点。你必须填充<tt>driver</tt>，<tt>host</tt>，<tt>database</tt>，<tt>user</tt>和<tt>pass</tt>的值，如果有值不需要填，填个双引号即可（<tt>""</tt>），每个'srcds'的实例都需要重启，否则改动不生效。

例子：
<pre>
"default"
{
"driver" "mysql"
"host" "数据库"
"database" "数据库名字"
"user" "账号"
"pass" "密码"
}
</pre>

==SQLite==
在你服务器的<tt>configs/databases.cfg</tt>文件中添加一个如下的节点：

<pre>
"admins"
{
"driver" "sqlite"
"database" "admins-sqlite"
}
</pre>

你可以使用任意合法的文件名作为数据库的名字，这里用“admins-sqlite”是因为这是预置的数据库，<tt>configs/sql-init-scripts/sqlite</tt>目录下可以找到<tt>admins-sqlite</tt>文件。

=数据库设置=
==自动==
确保<tt>sql-admin-manager.smx</tt>已加载，然后在'''服务器控制台'''中执行<tt>sm_create_adm_tables</tt>。如果使用的是MySQL，你需要有数据库的<tt>CREATE</tt>权限。

==手动==
===MySQL===
如果你还没有在你的MySQL中创建数据库里，这样做。

找到SourceMod中的<tt>configs/sql-init-scripts/mysql/create_admins.sql</tt>脚本。然后通过数据库命令行或者类似[http://www.phpmyadmin.net/ phpMyAdmin]的工具执行里面的内容，这个脚本会创建必要的表。

===SQLite===
SourceMod发布有一个预置的SQLite数据库文件，里面已经建好所有的表。如果你想手动创建数据库或者添加表，使用<tt>configs/sql-init-scripts/sqlite/create_admins.sql</tt>脚本的内容。

把二进制文件<tt>configs/sql-init-scripts/sqlite/admins-sqlite.sq3</tt>拷贝至你服务器的<tt>data/sqlite</tt>目录下，如果你在<tt>databases.cfg</tt>中重命名了数据库，那么你应该也同时重命名这个文件。

=启用插件=
所有的SQL插件都在<tt>plugins/disabled</tt>目录下——默认不加载。要启用插件，只需要把他们从<tt>plugins/disabled</tt>目录移动到<tt>plugins</tt>目录下。

你会比较想启用<tt>sql-admin-manager.smx</tt>插件，因为它提供了一些非常有用的控制台指令来进行管理。但是，另外两个插件，你同时只能启用其中'''一个'''： However, you should only enable '''ONE''' of the other two SQL plugins:

<ol>
<li><tt>admin-sql-prefetch.smx</tt>: 这个插件是中小型低延迟数据库的理想选择，它在地图加载时加载权限（或者主动刷新时），如果数据库延迟很大，或者你希望增删改权限后不需要刷新每个服务器的缓存，那么这个插件不适合你。
<ul>
<li>优点: 非常简单的插件，不复杂</li>
<li>缺点: 当缓存刷新时服务器会有延迟（地图加载或者使用<tt>sm_reloadadmins</tt>）。如果你增删改权限表了，在缓存刷新前改动不会有体现。</li>
</ul>
</li>

<li><tt>admin-sql-threaded.smx</tt>: 这个插件完全线程化了。因此它十分复杂，现在也是“实验”性质的（尽管测试运行良好）。它预加载所有的组权限和覆写信息，管理员查找也是动态完成的。
<ul>
<li>优点:糟糕的数据库连接不会卡顿服务器。如果你增删改了管理员，变动会在玩家连接服务器时实时体现。</li>
<li>缺点:代码非常复杂，不适合作自定义修改，同时它有一些副作用（比如，<tt>sm_reloadadmins</tt>指令会有轻微的延迟，因为插件是多线程的）</li>
</ul>
</li>
</ol>

一旦你启用了管理插件，并且启用了<tt>admin-sql</tt>插件的其中一个，那么可以继续往下了。

=更新表=
==自动==
确保插件<tt>sql-admin-manager.smx</tt>已加载，然后在服务器控制台中执行<tt>sm_update_adm_tables</tt>指令，如果你使用的是MySQL，你必须就有数据库的<tt>CREATE</tt>和<tt>ALTER</tt>权限。

==手动==
如果你正在使用的是旧版SourceMod表结构，那么更新最新架构的表结构非常重要。

总结一下:
*先备份所有数据。
*要明确你的旧表是依据什么建立的，不幸的是，目前唯一的办法就是记住你当时使用的SourceMod版本。
*找到所有服务器上像<tt>update_admins-rXXXX</tt>这个格式的脚本，其中<tt>XXXX</tt>是修订的版本号，需要的是版本比第二步中的高，但比你现在使用的版本低或者相同的脚本。
*按照递增的修订号执行匹配的脚本（最低的先执行，最高的最后执行）。
*升级SQL插件，以及任何依赖于管理员表的第三方软件。

升级表结构的脚本在<tt>configs/sql-init-scripts/<driver>/update_admins-rXXXX</tt>，其中XXXX是修订版本号。

下面是一种可能的场景。（数据是编的，实际的修订版本号完全不同）。

你的表是在r2978版的SourceMod下建立的，现在的版本是3512，那么下面是可能存在的文件：
*<tt>update_admins-r2500.sql</tt>
*<tt>update_admins-r3243.sql</tt>
*<tt>update_admins-r3444.sql</tt>

在这种情况下，你应当依次执行脚本<tt>3243</tt>和<tt>3444</tt>，来把你的表升级到最新版。所有的数据都会被保留，但是还是推荐你在作数据库变更时进行数据备份。

=管理命令=
出于方便考虑，SourceMod通过插件<tt>sql-admin-manager.smx</tt>提供了一些基础的数据库的管理员管理命令。所有的命令都需要<tt>root<tt>的管理flag。

下面是一些使用惯例：
*当<authtype>被请求时，它意味着下面三者之一的值，<tt>steam</tt>, <tt>ip</tt>, or <tt>name</tt>。
*当<identity>被请求时，它是跟<tt>authtype</tt>匹配的唯一字符串。例如，<tt>steam</tt>代表Steam Id，<tt>ip</tt>代表IP地址，<tt>name</tt>代表半条命2中玩家的昵称。

注意: 如果字符串中有空格，那么它要用引号括起来！（译注：整个子串用引号括起来）

注意: 冒号是中断字符，所以Steam Id必须用引号括起来！

:{|
|- class="t2th"
| Command
| Format
| Description
|- class="t2td"
| sm_sql_addadmin
| <nowiki><alias> <authtype> <identity> <flags> [immunity] [password]</nowiki>
| Adds a new entry to the <tt>sm_admins</tt> table. The <tt>alias</tt> can be any value and is usually used to assign a readable name to an IP/SteamID.
|- class="t2td"
| sm_sql_deladmin
| <nowiki><authtype> <identity></nowiki>
| Removes an admin.
|- class="t2td"
| sm_sql_addgroup
| <nowiki><name> <flags> <immunity></nowiki>
| Adds a new group with the specified flags and immunity
|- class="t2td"
| sm_sql_delgroup
| <nowiki><name></nowiki>
| Removes the specified group. Quotation marks are optional if the name has odd characters.
|- class="t2td"
| sm_sql_setadmingroups
| <nowiki><authtype> <identity> [group1] ... [group N]</nowiki>
| Sets an admin's group list. The inheritance order is the order the groups are specified in. This sets, and does not add; thus specifying no groups removes the user from all groups. Example:
<tt>sm_sql_setadmingroups steam "STEAM_0:1:16" "Full Admins"</tt>
|- class="t2td"
| sm_create_adm_tables
|
| Creates the administration tables for SourceMod. Can only be run from the server console.
|- class="t2td"
| sm_update_adm_tables
|
| Updates the administration tables to the latest schema, preserving data as applicable. Can only be run from the server console.
|}

=Frequently Asked Questions=
Q: Can I use <tt>admin-sql</tt> and <tt>admin-flatfile</tt> at the same time?
A: Yes. The data will be merged together in SourceMod's cache.

Q: Can I use both the <tt>threaded</tt> and <tt>prefetch</tt> SQL plugins at the same time?
A: No.

Q: Can duplicate groups/admins be in the flat files and the SQL database?
A: Yup. They will be merged safely.

=Schemas=
This section documents the required portions of the admin table schema. You do not need to read or learn this unless you plan to use SQL directly.

The exact schemas for each driver are located in <tt>configs/sql-init-scripts</tt>. The purpose of this document is to explain the fields rather than list the exact structures.

==sm_admins==
This table is used to store administrators. Although the primary key is <tt>id</tt>, applications should enforce that <tt>authtype</tt> and <tt>identity</tt> have no combined duplicates.

Primary key: <tt>id</tt> (auto increments).

:{|
|- class="t2th"
| Field
| Type
| Purpose
|- class="t2td"
| id
| integer
| Unique integer identifying the row.
|- class="t2td"
| authtype
| string NOT NULL
Constrained to 'steam', 'name', or 'ip'
| Authentication type the identity is against.
|- class="t2td"
| identity
| string NOT NULL
| Steam ID, name, or IP address.
|- class="t2td"
| password
| string
| Password, if any, the admin must use.
|- class="t2td"
| flags
| string NOT NULL
| Permission flag string.
|- class="t2td"
| name
| string NOT NULL
| Alias used for external tools (all but ignored in SourceMod).
|- class="t2td"
| immunity
| integer NOT NULL
| Immunity level value.
|}

==sm_groups==
This table is used to store all groups entries. Although the primary key is <tt>id</tt>, applications should enforce that the <tt>name</tt> field stays unique.

Primary key: <tt>id</tt> (auto increments).

:{|
|- class="t2th"
| Field
| Type
| Purpose
|- class="t2td"
| id
| integer
| Unique integer identifying the row.
|- class="t2td"
| flags
| string NOT NULL
| Permissions flag string.
|- class="t2td"
| name
| string NOT NULL
| Unique name of the group.
|- class="t2td"
| immunity_level
| integer NOT NULL
| Immunity level value.
|}

==sm_admins_groups==
This table is used to map admins to the groups they will inherit.

Primary key: <tt>admin_id</tt>, <tt>group_id</tt>

:{|
|- class="t2th"
| Field
| Type
| Purpose
|- class="t2td"
| admin_id
| integer
| Reference to the <tt>sm_admins.id</tt> field. Specifies the admin inheriting the group.
|- class="t2td"
| group_id
| integer
| Reference to the <tt>sm_groups.id</tt> field. Specifies the group the admin is inheriting.
|- class="t2td"
| inherit_order
| integer NOT NULL
| Order of inheritance for the given admin. Lower means earlier inheritance.
|}

==sm_group_immunity==
This table is used to map which groups are immune from other groups.

Primary key: <tt>group_id</tt>, <tt>other_id</tt>

:{|
|- class="t2th"
| Field
| Type
| Purpose
|- class="t2td"
| group_id
| integer
| Reference to the <tt>sm_groups.id</tt> field. Specifies the group gaining immunity.
|- class="t2td"
| other_id
| integer
| Reference to the <tt>sm_groups.id</tt> field. Specifies who <tt>group_id</tt> is becoming immune from.
|}

==sm_group_overrides==
This table is used to specify group-based command overrides.

Primary key: <tt>group_id</tt>, <tt>type</tt>, <tt>name</tt>

:{|
|- class="t2th"
| Field
| Type
| Purpose
|- class="t2td"
| group_id
| integer
| Reference to the <tt>sm_groups.id</tt> field. Specifies the group the override is for.
|- class="t2td"
| type
| string NOT NULL
Constrained to 'command' or 'group'.
| Specifies whether the override is a command or a command group.
|- class="t2td"
| name
| string NOT NULL
| Command name.
|- class="t2td"
| access
| string NOT NULL
Constrained to 'allow' or 'deny'.
| Whether the command is allowed or denied to this group.
|}

==sm_overrides==
This table is used to specify global command overrides.

Primary key: <tt>type</tt>, <tt>name</tt>

:{|
|- class="t2th"
| Field
| Type
| Purpose
|- class="t2td"
| type
| string NOT NULL
Constrained to 'command' or 'group'.
| Specifies whether the override is a command or a command group.
|- class="t2td"
| name
| string NOT NULL
| Command name.
|- class="t2td"
| flags
| string NOT NULL
| Permissions flag string.
|}

==sm_config==
This table is used to specify configuration options.

Primary key: <tt>cfg_key</tt>.

:{|
|- class="t2th"
| Field
| Type
| Purpose
|- class="t2td"
| cfg_key
| string NOT NULL
| Configuration key.
|- class="t2td"
| cfg_value
| string NOT NULL
| Configuration value.
|}

''Note:'' As of this writing, the only configuration value is <tt>admin_version</tt>, and it specifies the revision the schema last changed.

友情翻译[[User:MisakaSora|MisakaSora]]

[[Category:SourceMod Documentation]]

SQL Admins (SourceMod)/zh - Revision history

MisakaSora: half translated