Implementation:Apache Shardingsphere SchemaMetaDataPersistService Persist

Knowledge Sources	Apache_Shardingsphere
Domains	Persistence, Metadata
Last Updated	2026-02-10 00:00 GMT

Overview

Persistence service for schema metadata operations including add, drop, and load with associated tables and views.

Description

SchemaMetaDataPersistService manages the persistence of schema metadata in the registry center. It handles schema creation, deletion, and loading of complete schema structures including all associated tables and views via TableMetaDataPersistService and ViewMetaDataPersistService.

Usage

Used by DatabaseMetaDataPersistFacade to manage schema persistence during DDL operations and metadata initialization.

Code Reference

Source Location

• Repository: Apache_Shardingsphere
• File: SchemaMetaDataPersistService.java
• Lines: 1-94

Signature

@RequiredArgsConstructor
public final class SchemaMetaDataPersistService {

    private final PersistRepository repository;

    public void add(String databaseName, String schemaName);
    public void drop(String databaseName, String schemaName);
    public ShardingSphereSchema load(String databaseName, String schemaName);
}

Import

import org.apache.shardingsphere.mode.metadata.persist.metadata.service.SchemaMetaDataPersistService;

I/O Contract

Inputs

Name	Type	Required	Description
databaseName	String	Yes	Target database
schemaName	String	Yes	Target schema

Outputs

Name	Type	Description
load() returns	ShardingSphereSchema	Complete schema with tables and views

Usage Examples

SchemaMetaDataPersistService service = persistFacade.getSchemaMetaDataService();

// Add a new schema
service.add("my_database", "public");

// Load schema with all tables and views
ShardingSphereSchema schema = service.load("my_database", "public");

// Drop a schema
service.drop("my_database", "old_schema");

Related Pages

• Principle:Apache_Shardingsphere_Metadata_Repository_Persistence