创建和管理命名架构

本页介绍了如何创建、使用和删除命名架构，以及如何对命名架构中的对象应用精细的访问控制。如需大致了解命名架构，请参阅命名架构。

准备工作

如需执行此页面上的过程，您需要满足以下条件：

创建命名架构

CREATE SCHEMA 命令（适用于 GoogleSQL 和 PostgreSQL）用于创建命名架构。

  1. 在 Google Cloud 控制台中，打开 Spanner 页面。

    转到 Spanner

  2. 从列表中选择一个实例。

  3. 选择一个数据库。

  4. 在导航菜单中，点击 Spanner Studio。

  5. 点击 新的 SQL 编辑器标签页或 新标签页以打开新标签页。

  6. 在编辑器标签页中，输入 DDL。

    GoogleSQL

    运行 CREATE SCHEMA 语句以创建命名架构，例如：

    CREATE SCHEMA sch1;

    在命名架构中添加数据库对象，例如：

    CREATE SEQUENCE sch1.sequence OPTIONS (
  sequence_kind = 'bit_reversed_positive'
);

CREATE TABLE Singers (
  SingerId INT64 NOT NULL,
  FirstName STRING(1024),
  LastName STRING(1024),
  SingerInfo BYTES(MAX),
) PRIMARY KEY(SingerId);

CREATE INDEX indexOnSingers ON Singers(FirstName);

CREATE TABLE Albums (
  SingerId INT64 NOT NULL,
  AlbumId INT64 NOT NULL,
  AlbumTitle STRING(MAX),
) PRIMARY KEY(SingerId, AlbumId),
  INTERLEAVE IN PARENT Singers ON DELETE CASCADE;

CREATE TABLE Songs (
  SingerId INT64 NOT NULL,
  AlbumId INT64 NOT NULL,
  TrackId INT64 NOT NULL,
  SongName STRING(MAX),
) PRIMARY KEY(SingerId, AlbumId, TrackId),
  INTERLEAVE IN PARENT Albums ON DELETE CASCADE;

CREATE TABLE sch1.Singers (
  SingerId INT64 NOT NULL,
  FirstName STRING(1024),
  LastName STRING(1024),
  SingerInfo BYTES(MAX),
) PRIMARY KEY(SingerId);

CREATE INDEX sch1.indexOnSingers ON sch1.Singers(FirstName);

CREATE TABLE sch1.Albums (
  SingerId INT64 NOT NULL,
  AlbumId INT64 NOT NULL,
  AlbumTitle STRING(MAX),
) PRIMARY KEY(SingerId, AlbumId),
  INTERLEAVE IN PARENT sch1.Singers ON DELETE CASCADE;

CREATE TABLE sch1.Songs (
  SingerId INT64 NOT NULL,
  AlbumId INT64 NOT NULL,
  TrackId INT64 NOT NULL,
  SongName STRING(MAX),
) PRIMARY KEY(SingerId, AlbumId, TrackId),
  INTERLEAVE IN PARENT sch1.Albums ON DELETE CASCADE;

CREATE VIEW sch1.SingerView SQL SECURITY INVOKER
  AS Select s.FirstName, s.LastName, s.SingerInfo
  FROM sch1.Singers AS s WHERE s.SingerId = 123456;

CREATE VIEW SingerView SQL SECURITY INVOKER
  AS Select s.FirstName, s.LastName, s.SingerInfo
  FROM Singers AS s WHERE s.SingerId = 123456;

    在 Spanner 中，您只能创建与使用该索引的表使用相同架构的索引。我们需要确保索引和表架构名称相同。

    PostgreSQL

    运行 CREATE SCHEMA 语句以创建命名架构，例如：

    CREATE SCHEMA sch1;

    在命名架构中添加数据库对象，例如：

    CREATE SEQUENCE sch1.sequence BIT_REVERSED_POSITIVE
CREATE TABLE sch1.singers(
  singer_id bigint primary key, album_id bigint default(nextval('sch1.sequence')))
CREATE TABLE sch1.albums(k bigint default(nextval('sch1.sequence'))primary key, album_id bigint)

CREATE VIEW sch1.singer_view SQL SECURITY INVOKER
  AS SELECT * FROM sch1.singers
CREATE INDEX index_singers ON TABLE sch1.singers(album_id)

    Spanner 仅允许在同一架构中创建索引。在 Spanner 中，PostgreSQL 语句会默认执行此操作。您无需使用完全限定名称即可在命名架构上创建索引。

  7. 在探索器窗格中查看命名架构和相关对象。

向命名架构添加精细访问权限控制

以下 DDL 语句会向命名架构添加精细的访问权限控制：

  • USAGE 特权可向架构对象授予特权。默认情况下，系统会向默认架构授予 USAGE 权限。不过，您可以撤消默认架构的 USAGE 权限。撤消访问权限时请务必谨慎，因为被撤消访问权限的用户和角色会失去对默认架构中对象的所有访问权限。
  • ALL 语句会对架构中某种类型的所有对象批量授予特权。
  • DEFAULT 关键字是指 FGAC DDL 语句中的默认架构。

如需访问命名架构中的对象，您必须拥有对该命名架构的使用权限，以及对使用该架构的数据库对象的相应权限。以下语句可提供这些权限：

  • GRANT ALL（GoogleSQL 和 PostgreSQL）会授予角色对使用指定架构创建的表中的所有对象的访问权限。此语句仅适用于在该时间点存在的对象。如果您稍后向表中添加更多对象，则需要在创建这些对象时授予对这些对象的访问权限。
  • GRANT USAGE（GoogleSQL 和 PostgreSQL）会向角色授予访问架构中包含的对象的权限。这样，受让人便可以查询架构中的对象。

  1. 在 Google Cloud 控制台中，打开 Spanner 页面。

    转到 Spanner

  2. 从列表中选择一个实例。

  3. 选择一个数据库。

  4. 在导航菜单中，点击 Spanner Studio。

  5. 点击 新的 SQL 编辑器标签页或 新标签页以打开新标签页。

  6. 在编辑器标签页中，输入 DDL。

    GoogleSQL

    为命名架构创建自定义角色。在以下示例中，我们使用 role1 和 role2。

    CREATE ROLE role1
CREATE ROLE role2

    使用 GRANT ALL 向使用命名架构的表授予角色。在以下示例中，我们将为命名架构使用 sch1，并为角色使用 role1。

    GRANT SELECT ON ALL TABLES IN SCHEMA sch1 TO ROLE role1

    向您创建的角色授予对架构的使用权限。在以下示例中，我们向 role1 和 role2 授予了对 sch1 的使用权限。

    GRANT USAGE ON SCHEMA sch1 TO ROLE role1, role2

    PostgreSQL

    为命名架构创建自定义角色。在以下示例中，我们使用 role1 和 role2。

    CREATE ROLE role1
CREATE ROLE role2

    使用 GRANT ALL 向使用命名架构的表授予角色。在以下示例中，我们将为命名架构使用 sch1，并为角色使用 role1。

    GRANT SELECT ON ALL TABLES IN SCHEMA sch1 TO role1

    向您创建的角色授予对架构的使用权限。在以下示例中，我们向 role1 和 role2 授予了对 sch1 的使用权限。

    GRANT USAGE ON SCHEMA sch1 TO role1, role2

向默认架构添加和撤消精细访问权限控制

当您有命名架构时，默认架构称为 default。添加或撤消精细访问权限控制时，您需要使用 default 架构名称。

向默认架构添加精细访问权限控制

默认情况下，所有用户和角色对默认架构都有 USAGE 权限。

  1. 在 Google Cloud 控制台中，打开 Spanner 页面。

    转到 Spanner

  2. 从列表中选择一个实例。

  3. 选择一个数据库。

  4. 在导航菜单中，点击 Spanner Studio。

  5. 点击 新的 SQL 编辑器标签页或 新标签页以打开新标签页。

  6. 在编辑器标签页中，输入 DDL。

    GoogleSQL

    在以下示例中，我们向 role1 授予对所有表的访问权限。

    GRANT SELECT ON ALL TABLES IN SCHEMA default TO ROLE role1

    PostgreSQL

    在以下示例中，我们向 role1 授予对所有表的访问权限。

    GRANT SELECT ON ALL TABLES IN SCHEMA default TO role1

撤消对默认架构的精细访问权限控制

您可以使用 REVOKE USAGE 命令撤消对默认架构的默认精细访问控制权限。

  1. 在 Google Cloud 控制台中，打开 Spanner 页面。

    转到 Spanner

  2. 从列表中选择一个实例。

  3. 选择一个数据库。

  4. 在导航菜单中，点击 Spanner Studio。

  5. 点击 新的 SQL 编辑器标签页或 新标签页以打开新标签页。

  6. 在编辑器标签页中，输入 DDL。

    GoogleSQL 

    REVOKE USAGE ON SCHEMA DEFAULT FROM ROLE public

    PostgreSQL

    REVOKE USAGE ON SCHEMA public FROM public

  7. 运行上一个命令后，我们必须向需要访问默认架构的角色明确授予权限。在以下示例中，我们向 role1 授予权限。

    GoogleSQL

    在以下示例中，我们向 role1 授予对默认架构的访问权限。

    GRANT USAGE ON SCHEMA default to ROLE role1

    PostgreSQL

    在以下示例中，我们向 role1 授予了对默认架构的访问权限。

    GRANT USAGE ON SCHEMA public To role1

查看命名架构

  1. 从列表中选择一个实例。
  2. 选择一个数据库。
  3. 在导航菜单中，点击 Spanner Studio。

  4. 在探索器窗格中，展开架构下拉列表。

    展开“架构”列表的资源管理器

或者，您也可以使用 SQL 查看 information_schema.schemata 表中的所有架构。

以下示例展示了如何命名架构及其所有者：

SELECT schema_name, schema_owner
  FROM information_schema.schemata
  ORDER BY schema_owner

此语句会提供架构和所有者的列表，类似于以下内容：

public spanner_admin
products  spanner_admin
analytics  spanner_admin
logs  spanner_admin
pg_catalog spanner_system
information_schema spanner_system
spanner_sys   spanner_system

删除命名架构

DROP SCHEMA 命令（适用于 GoogleSQL 和 PostgreSQL）用于删除命名架构。

  1. 在 Google Cloud 控制台中，打开 Spanner 页面。

    转到 Spanner

  2. 从列表中选择一个实例。

  3. 选择一个数据库。

  4. 在导航菜单中，点击 Spanner Studio。

  5. 点击 新的 SQL 编辑器标签页或 新标签页以打开新标签页。

  6. 在编辑器标签页中，输入 DDL。

    GoogleSQL

    在以下示例中，我们会删除 sch1。

    DROP SCHEMA IF EXISTS sch1;

    PostgreSQL

    在以下示例中，我们会删除 sch1。

    DROP SCHEMA IF EXISTS sch1;

后续步骤