Hibernate
/
hibernate-orm
mirror of https://github.com/hibernate/hibernate-orm
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

mention Persistence.generateSchema() in doc

This commit is contained in:
Gavin King 2023-08-09 19:58:03 +02:00
parent d3b6eaea53
commit c70b6946b1
2 changed files with 11 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
documentation/src/main/asciidoc/introduction/Configuration.adoc
View File

@ -368,17 +368,24 @@ This feature is extremely useful for testing.
// .Importing test or reference data // .Importing test or reference data
==== ====
The easiest way to pre-initialize a database with test or "reference" data is to place a list of SQL `insert` statements in a file named, for example, `import.sql`, and specify the path to this file using the property `jakarta.persistence.schema-generation.create-script-source`. The easiest way to pre-initialize a database with test or "reference" data is to place a list of SQL `insert` statements in a file named, for example, `import.sql`, and specify the path to this file using the property `jakarta.persistence.schema-generation.create-script-source`.
We've already seen an <<import.sql,example>> of this approach, which is cleaner than writing Java code to instantiate entity instances and calling `persist()` on each of them.
This approach is cleaner than writing Java code to instantiate entity instances and calling `persist()` on each of them.
==== ====
As we mentioned <<testing,earlier>>, it can also be useful to control schema export programmatically.
[TIP] [TIP]
// .Programmatic schema export // .Programmatic schema export
==== ====
Alternatively, the `SchemaManager` API allow you to control schema export programmatically. The `SchemaManager` API allows programmatic control over schema export:
[source,java] [source,java]
sessionFactory.getSchemaManager().exportMappedObjects(true); sessionFactory.getSchemaManager().exportMappedObjects(true);
JPA has a more limited and less ergonomic API:
[source,java]
Persistence.generateSchema("org.hibernate.example",
Map.of(JAKARTA_HBM2DDL_DATABASE_ACTION, CREATE))
==== ====
[[logging-generated-sql]] [[logging-generated-sql]]

1
documentation/src/main/asciidoc/introduction/Introduction.adoc
View File

@ -648,6 +648,7 @@ sessionFactory.getSchemaManager().truncateMappedObjects();
After truncating tables, we might need to initialize our test data. After truncating tables, we might need to initialize our test data.
We may specify test data in a SQL script, for example: We may specify test data in a SQL script, for example:
[[import.sql]]
[source,sql] [source,sql]
./import.sql ./import.sql
---- ----