Criar e gerenciar esquemas nomeados

Esta página descreve como criar, usar e excluir esquemas nomeados e como aplicar controle de acesso detalhado a objetos em esquemas nomeados. Para informações gerais sobre para esquemas nomeados, consulte Esquemas nomeados.

Antes de começar

Para realizar os procedimentos desta página, você precisa do seguinte:

Criar um esquema nomeado

O comando CREATE SCHEMA (GoogleSQL e PostgreSQL) é usada para criar um esquema nomeado.

  1. No console do Google Cloud, abra a página Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista.

  3. Selecione um banco de dados.

  4. No menu de navegação, clique em Spanner Studio.

  5. Abra uma nova guia clicando em New SQL editor tab ou New tab.

  6. Na guia Editor, insira o DDL.

    GoogleSQL

    Execute a instrução CREATE SCHEMA para criar o esquema nomeado, por exemplo:

    CREATE SCHEMA sch1;
    

    Adicione objetos de banco de dados no esquema nomeado, por exemplo:

    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;
    

    O Spanner só permite criar um índice que usa o mesmo esquema da tabela que usa o índice. Precisamos garantir que os nomes do índice e do esquema da tabela sejam iguais.

    PostgreSQL

    Execute a instrução CREATE SCHEMA para criar o esquema nomeado, por exemplo:

    CREATE SCHEMA sch1;
    

    Adicione objetos de banco de dados no esquema nomeado, por exemplo:

    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)
    

    O Spanner só permite a criação de índices no mesmo esquema. Em As instruções do Spanner e PostgreSQL fazem isso padrão. Não é necessário usar nomes totalmente qualificados para criar índices em esquemas nomeados.

  7. Confira os esquemas nomeados e objetos relacionados no painel Explorer.

Adicionar controle de acesso granular a um esquema nomeado

As instruções DDL a seguir adicionam controle de acesso detalhado a um esquema nomeado:

  • O privilégio USAGE concede privilégios ao objeto do esquema. O privilégio USAGE é concedido por padrão ao esquema padrão. No entanto, é possível revogar o privilégio USAGE para o esquema padrão. Tenha cuidado ao a revogação do acesso porque usuários e papéis que são revogados perdem todo o acesso a no esquema padrão.
  • A instrução ALL executa privilégios de concessão em massa em TODOS os objetos de um tipo em o esquema.
  • A palavra-chave DEFAULT se refere ao esquema padrão nas instruções DDL da FGAC.

Para acessar um objeto em um esquema nomeado, é necessário ter permissão de uso no esquema nomeado e permissões correspondentes nos objetos de banco de dados que usam esse esquema. As instruções a seguir fornecem essas permissões:

  • GRANT ALL (GoogleSQL e PostgreSQL) concede a permissão de função para acessar todos os objetos na tabela criada com o esquema nomeado. Essa instrução só se aplica a objetos que existem no em um determinado momento. Se você adicionar mais objetos à tabela mais tarde, precisará conceder acesso a esses objetos à medida que eles são criados.
  • GRANT USAGE (GoogleSQL e PostgreSQL) concede à função a permissão para acessar objetos contidos no esquema. Isso permite que o beneficiário procure objetos no esquema.
  1. No console do Google Cloud, abra a página Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista.

  3. Selecione um banco de dados.

  4. No menu de navegação, clique em Spanner Studio.

  5. Abra uma nova guia clicando em New SQL editor tab ou New tab.

  6. Na guia Editor, insira o DDL.

    GoogleSQL

    Crie o papel personalizado para o esquema nomeado. No exemplo a seguir, usamos role1 e role2.

    CREATE ROLE role1
    CREATE ROLE role2
    

    Conceda a função às tabelas que usam o esquema nomeado usando GRANT ALL. No exemplo a seguir, usamos sch1 para o esquema nomeado e role1 para o papel.

    GRANT SELECT ON ALL TABLES IN SCHEMA sch1 TO ROLE role1
    

    Conceda o uso no esquema para as funções que você criou. No exemplo a seguir, concedemos o uso de sch1 para role1 e role2.

    GRANT USAGE ON SCHEMA sch1 TO ROLE role1, role2
    

    PostgreSQL

    Crie o papel personalizado para o esquema nomeado. No exemplo a seguir, usamos role1 e role2.

    CREATE ROLE role1
    CREATE ROLE role2
    

    Conceda a função às tabelas que usam o esquema nomeado usando GRANT ALL. No exemplo a seguir, usamos sch1 para o esquema nomeado e role1 para o papel.

    GRANT SELECT ON ALL TABLES IN SCHEMA sch1 TO role1
    

    Conceda o uso no esquema para as funções que você criou. Nos seguintes exemplo, concedemos o uso em sch1 para role1 e role2.

    GRANT USAGE ON SCHEMA sch1 TO role1, role2
    

Adicionar e revogar o controle de acesso detalhado a um esquema padrão

Quando você tem esquemas nomeados, o esquema padrão é chamado de default. Você precisa usar o nome do esquema default ao adicionar ou revogar o controle de acesso detalhado.

Adicionar controle de acesso granular a um esquema padrão

Por padrão, todos os usuários e funções têm a permissão USAGE no padrão esquema.

  1. No console do Google Cloud, abra a página Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista.

  3. Selecione um banco de dados.

  4. No menu de navegação, clique em Spanner Studio.

  5. Abra uma nova guia clicando em New SQL editor tab ou New tab.

  6. Na guia Editor, insira o DDL.

    GoogleSQL

    No exemplo a seguir, concedemos acesso a todas as tabelas para role1.

    GRANT SELECT ON ALL TABLES IN SCHEMA default TO ROLE role1
    

    PostgreSQL

    No exemplo abaixo, concedemos acesso a todas as tabelas para role1.

    GRANT SELECT ON ALL TABLES IN SCHEMA default TO role1
    

Revogar o controle de acesso granular a um esquema padrão

É possível revogar as permissões de controle de acesso detalhadas padrão no esquema padrão usando o comando REVOKE USAGE.

  1. No console do Google Cloud, abra a página Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista.

  3. Selecione um banco de dados.

  4. No menu de navegação, clique em Spanner Studio.

  5. Abra uma nova guia clicando em New SQL editor tab ou New tab.

  6. Na guia Editor, insira o DDL.

    GoogleSQL

    REVOKE USAGE ON SCHEMA DEFAULT FROM ROLE public
    

    PostgreSQL

    REVOKE USAGE ON SCHEMA public FROM public
    
  7. Depois que o comando anterior é executado, devemos conceder permissões explicitamente para os papéis que precisam acessar o esquema padrão. No exemplo abaixo, concedemos permissões a role1.

    GoogleSQL

    No exemplo a seguir, concedemos acesso ao esquema padrão para role1:

    SCHEMA default to ROLE role1
    

    PostgreSQL

    No exemplo abaixo, concedemos acesso ao esquema padrão a role1.

    GRANT USAGE ON SCHEMA public To role1
    

Conferir esquemas nomeados

  1. Selecione uma instância na lista.
  2. Selecione um banco de dados.
  3. No menu de navegação, clique em Spanner Studio.
  4. No painel Explorador, expanda a lista suspensa Esquemas.

    Explorador com a lista de esquemas expandida

Como alternativa, use o SQL para conferir todos os esquemas na tabela information_schema.schemata.

O exemplo a seguir mostra como os esquemas de nomes de visualização e os proprietários são mostrados:

SELECT schema_name, schema_owner
  FROM information_schema.schemata
  ORDER BY schema_owner

Essa instrução fornece uma lista de esquemas e proprietários, semelhante à seguinte:

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

Remover um esquema nomeado

O comando DROP SCHEMA (GoogleSQL e PostgreSQL) é usado para excluir um esquema nomeado.

  1. No console do Google Cloud, abra a página Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista.

  3. Selecione um banco de dados.

  4. No menu de navegação, clique em Spanner Studio.

  5. Abra uma nova guia clicando em New SQL editor tab ou New tab.

  6. Na guia Editor, insira o DDL.

    GoogleSQL

    No exemplo abaixo, descartamos sch1.

    DROP SCHEMA IF EXISTS sch1;
    

    PostgreSQL

    No exemplo a seguir, sch1 é descartado.

    DROP SCHEMA IF EXISTS sch1;
    

A seguir