Spring Cloud Cloud Spanner 关系

Spring Data Cloud Spanner使用Cloud Spanner 父子交错表机制支持父子关系 。Cloud Spanner交错表强制一对多关系，并在单个域父实体的实体上提供有效的查询和操作。这些关系最多可以达到7个层次。Cloud Spanner还提供了自动级联删除或强制删除父级之前的子实体。

尽管可以使用交错的父子表构建在Cloud Spanner和Spring Data Cloud Spanner中实现一对一和多对多关系，但仅本地支持父子关系。Cloud Spanner不支持外键约束，尽管父子键约束在与交错表一起使用时会强制执行类似的要求。

例如，以下Java实体：

@Table(name = "Singers")
class Singer {
  @PrimaryKey
  long SingerId;

  String FirstName;

  String LastName;

  byte[] SingerInfo;

  @Interleaved
  List<Album> albums;
}

@Table(name = "Albums")
class Album {
  @PrimaryKey
  long SingerId;

  @PrimaryKey(keyOrder = 2)
  long AlbumId;

  String AlbumTitle;
}

这些类可以对应于一对现有的交错表。@Interleaved批注可以应用于Collection属性，并且内部类型被解析为子实体类型。创建它们所需的架构也可以使用SpannerSchemaUtils生成，并使用SpannerDatabaseAdminTemplate执行：

@Autowired
SpannerSchemaUtils schemaUtils;

@Autowired
SpannerDatabaseAdminTemplate databaseAdmin;
...

// Get the create statmenets for all tables in the table structure rooted at Singer
List<String> createStrings = this.schemaUtils.getCreateTableDdlStringsForInterleavedHierarchy(Singer.class);

// Create the tables and also create the database if necessary
this.databaseAdmin.executeDdlStrings(createStrings, true);

createStrings列表包含表架构语句，这些语句使用与提供的Java类型兼容的列名称和类型，以及根据配置的自定义转换器包含在其中的任何已解析子关系类型。

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

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;

ON DELETE CASCADE子句表示如果删除歌手，则Cloud Spanner会删除该歌手的所有专辑。另一种选择是ON DELETE NO ACTION，在此歌手要删除所有歌手的专辑之后才能删除。使用SpannerSchemaUtils生成架构字符串时，spring.cloud.gcp.spanner.createInterleavedTableDdlOnDeleteCascade布尔设置确定这些架构是针对true的ON DELETE CASCADE还是针对false的ON DELETE NO ACTION生成的。

Cloud Spanner将这些关系限制为7个子层。一个表可能有多个子表。

在将对象更新或插入Cloud Spanner时，其所有引用的子对象也将分别更新或插入同一请求中。在读取时，所有交错的子行也都被读取。