schemaspy:schemaspy
Note:
This goal should be used as a Maven report.
Full name:
nl.geodienstencentrum.maven:schemaspy-maven-plugin:5.3.1-SNAPSHOT:schemaspy
Description:
The SchemaSpy Maven plugin report.
Attributes:
- Requires a Maven project to be executed.
- The goal is not marked as thread-safe and thus does not support parallel builds.
- Since version:
2.0
. - Binds by default to the lifecycle phase:
site
.
Required Parameters
Name | Type | Since | Description |
---|---|---|---|
<database> |
String |
- |
The name of the database being analysed. User Property: database |
Optional Parameters
Name | Type | Since | Description |
---|---|---|---|
<allowHtmlInComments> |
Boolean |
- |
Allow HTML In Comments. Any HTML embedded in comments normally gets encoded so that it's rendered as text. This option allows it to be rendered as HTML. User Property: allowHtmlInComments |
<catalog> |
String |
- |
No description. Default: % User Property: catalog |
<commentsInitiallyDisplayed> |
Boolean |
- |
Deprecated. this seems to no longer be a supported option in SchemaSpy Comments Initially Displayed. Column comments are normally hidden by default. This option displays them by default. User Property: commentsInitiallyDisplayed |
<connprops> |
String |
- |
Specifies additional properties to be used when connecting to the database. Specify the entries directly, escaping the ='s with \= and separating each key\=value pair with a ;. May also be a file name, useful for hiding connection properties from public logs. User Property: connprops |
<cssStylesheet> |
String |
- |
The CSS Stylesheet. Allows you to override the default SchemaSpyCSS stylesheet. User Property: cssStylesheet |
<databaseType> |
String |
- |
The type of database being analysed - defaults to ora. User Property: databaseType |
<excludeColumnNamesRegex> |
String |
- |
Exclude matching columns from relationship analysis to simplify the generated graphs. This is a regular expression that's used to determine which columns to exclude. It must match table name, followed by a dot, followed by column name. For example: -x "(book.isbn)|(borrower.address)" Note that each column name regular expression must be surround by ()'s and separated from other column names by a |. User Property: excludeColumnNamesRegex |
<highQuality> |
Boolean |
- |
Generate higher-quality diagrams. Various installations of Graphviz (depending on OS and/or version) will default to generating either higher or lower quality images. That is, some might not have the "lower quality" libraries and others might not have the "higher quality" libraries. User Property: highQuality |
<host> |
String |
- |
The host address of the database being analysed. User Property: host |
<includeTableNamesRegex> |
String |
- |
Only include matching tables/views. This is a regular expression that's used to determine which tables/views to include. For example: -i "(.*book.*)|(library.*)" includes only those tables/views with 'book' in their names or that start with 'library'. You might want to use "description" with this option to describe the subset of tables. User Property: includeTableNamesRegex |
<locale> |
String |
- |
The locale to use when the report generation is invoked directly as a standalone Mojo. See also: org.apache.maven.doxia.tools.SiteTool.DEFAULT_LOCALE, org.apache.maven.doxia.tools.SiteTool.getSiteLocales(java.lang.String) Default: default |
<logLevel> |
String |
- |
Detail of execution logging. User Property: logLevel |
<lowQuality> |
Boolean |
- |
Generate lower-quality diagrams. Various installations of Graphviz (depending on OS and/or version) will default to generating either higher or lower quality images. That is, some might not have the "lower quality" libraries and others might not have the "higher quality" libraries. User Property: lowQuality |
<noAds> |
Boolean |
- |
Deprecated. will be removed Don't generate ads in reports. Default: true User Property: noAds |
<noHtml> |
Boolean |
- |
Only generate files needed for insertion/deletion of data (e.g. for scripts). User Property: noHtml |
<noImplied> |
Boolean |
- |
Don't include implied foreign key relationships in the generated table details. User Property: noImplied |
<noLogo> |
Boolean |
- |
Deprecated. will be removed Don't generate sourceforge logos in reports. Default: true User Property: noLogo |
<noRows> |
Boolean |
- |
Don't query or display row counts. User Property: noRows |
<noSchema> |
Boolean |
- |
No schema required for this database (e.g. derby). User Property: noSchema |
<noViews> |
Boolean |
- |
Don't query or display row counts. User Property: noViews |
<outputDirectory> |
String |
- |
The output directory where the final HTML reports will be generated. Note that the reports are always generated in a directory called "schemaspy". The output directory refers to the directory in which the "schemaspy" will be generated. Default: ${project.build.directory}/site User Property: outputDirectory |
<outputFormat> |
String |
- |
The report output format: null by default, to represent a site, but can be configured to a Doxia Sink id. User Property: output.format |
<outputTimestamp> |
String |
- |
Timestamp for reproducible output archive entries, either formatted as ISO 8601 yyyy-MM-dd'T'HH:mm:ssXXX or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH).Default: ${project.build.outputTimestamp} |
<password> |
String |
- |
Database password to use - defaults to none. User Property: password |
<pathToDrivers> |
String |
- |
If specified, SchemaSpy will look for JDBC drivers on this path, rather than using the application classpath. Useful if your database has a non-O/S driver not bundled with the plugin. User Property: pathToDrivers |
<port> |
String |
- |
The port, required by some drivers. User Property: port |
<runOnExecutionRoot> |
boolean |
5.0.4 |
Whether to create the report only on the execution root of a multi-module project. Default: false User Property: runOnExecutionRoot |
<schema> |
String |
- |
Database schema to use - defaults to the specified user. User Property: schema |
<schemaDescription> |
String |
- |
Schema description. Displays the specified textual description on summary pages. If your description includes an equals sign then escape it with a backslash. NOTE: This field doesn't seem to be used by SchemaSpy in the current version. User Property: schemaDescription |
<schemas> |
String |
- |
Evaluate specified schemas. Similar to -showAllSchemas, but explicitly specifies which schema to evaluate without interrogating the database's metadata. Can be used with databases like MySQL where a database isn't composed of multiple schemas. User Property: schemas |
<showAllSchemas> |
Boolean |
- |
Evaluate all schemas in a database. Generates a high-level index of the schemas evaluated and allows for traversal of cross-schema foreign key relationships. Use with -schemaSpec "schemaRegularExpression" to narrow-down the schemas to include. User Property: showAllSchemas |
<singleSignOn> |
Boolean |
- |
Single Sign-On. Don't require a user to be specified with -user to simplify configuration when running in a single sign-on environment. User Property: singleSignOn |
<siteDirectory> |
File |
- |
Directory containing the site.xml file.Default: ${basedir}/src/site |
<targetDirectory> |
File |
- |
The output directory for the intermediate report. Default: ${project.build.directory} User Property: targetDirectory |
<useDriverManager> |
Boolean |
- |
Some databases, like Derby, will crash if you use the old driver object to establish a connection (eg "connection = driver.connect(...)"). In this case, set useDriverManager to true to use the DriverManager.getConnection() method instead (eg "connection = java.sql.DriverManager.getConnection(...)"). Other databases (eg MySQL) seem to only work with the first method, so don't use this parameter unless you have to. User Property: useDriverManager |
<user> |
String |
- |
Connect to the database with this user id. User Property: user |
<vizjs> |
boolean |
- |
No description. Default: true User Property: vizjs |
Parameter Details
<allowHtmlInComments>
Allow HTML In Comments. Any HTML embedded in comments normally gets encoded so that it's rendered as text. This option allows it to be rendered as HTML.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
allowHtmlInComments
<catalog>
No description.
- Type:
java.lang.String
- Required:
No
- User Property:
catalog
- Default:
%
<commentsInitiallyDisplayed>
Deprecated.
this seems to no longer be a supported option in SchemaSpy
this seems to no longer be a supported option in SchemaSpy
Comments Initially Displayed. Column comments are normally hidden by default. This option displays them by default.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
commentsInitiallyDisplayed
<connprops>
Specifies additional properties to be used when connecting to the database. Specify the entries directly, escaping the ='s with \= and separating each key\=value pair with a ;. May also be a file name, useful for hiding connection properties from public logs.
- Type:
java.lang.String
- Required:
No
- User Property:
connprops
<cssStylesheet>
The CSS Stylesheet. Allows you to override the default SchemaSpyCSS stylesheet.
- Type:
java.lang.String
- Required:
No
- User Property:
cssStylesheet
<database>
The name of the database being analysed.
- Type:
java.lang.String
- Required:
Yes
- User Property:
database
<databaseType>
The type of database being analysed - defaults to ora.
- Type:
java.lang.String
- Required:
No
- User Property:
databaseType
<excludeColumnNamesRegex>
Exclude matching columns from relationship analysis to simplify the generated graphs. This is a regular expression that's used to determine which columns to exclude. It must match table name, followed by a dot, followed by column name. For example: -x "(book.isbn)|(borrower.address)" Note that each column name regular expression must be surround by ()'s and separated from other column names by a |.
- Type:
java.lang.String
- Required:
No
- User Property:
excludeColumnNamesRegex
<highQuality>
Generate higher-quality diagrams. Various installations of Graphviz (depending on OS and/or version) will default to generating either higher or lower quality images. That is, some might not have the "lower quality" libraries and others might not have the "higher quality" libraries.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
highQuality
<host>
The host address of the database being analysed.
- Type:
java.lang.String
- Required:
No
- User Property:
host
<includeTableNamesRegex>
Only include matching tables/views. This is a regular expression that's used to determine which tables/views to include. For example: -i "(.*book.*)|(library.*)" includes only those tables/views with 'book' in their names or that start with 'library'. You might want to use "description" with this option to describe the subset of tables.
- Type:
java.lang.String
- Required:
No
- User Property:
includeTableNamesRegex
<locale>
The locale to use when the report generation is invoked directly as a standalone Mojo.
See also: org.apache.maven.doxia.tools.SiteTool.DEFAULT_LOCALE, org.apache.maven.doxia.tools.SiteTool.getSiteLocales(java.lang.String)
See also: org.apache.maven.doxia.tools.SiteTool.DEFAULT_LOCALE, org.apache.maven.doxia.tools.SiteTool.getSiteLocales(java.lang.String)
- Type:
java.lang.String
- Required:
No
- Default:
default
<logLevel>
Detail of execution logging.
- Type:
java.lang.String
- Required:
No
- User Property:
logLevel
<lowQuality>
Generate lower-quality diagrams. Various installations of Graphviz (depending on OS and/or version) will default to generating either higher or lower quality images. That is, some might not have the "lower quality" libraries and others might not have the "higher quality" libraries.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
lowQuality
<noAds>
Deprecated.
will be removed
will be removed
Don't generate ads in reports.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
noAds
- Default:
true
<noHtml>
Only generate files needed for insertion/deletion of data (e.g. for scripts).
- Type:
java.lang.Boolean
- Required:
No
- User Property:
noHtml
<noImplied>
Don't include implied foreign key relationships in the generated table details.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
noImplied
<noLogo>
Deprecated.
will be removed
will be removed
Don't generate sourceforge logos in reports.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
noLogo
- Default:
true
<noRows>
Don't query or display row counts.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
noRows
<noSchema>
No schema required for this database (e.g. derby).
- Type:
java.lang.Boolean
- Required:
No
- User Property:
noSchema
<noViews>
Don't query or display row counts.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
noViews
<outputDirectory>
The output directory where the final HTML reports will be generated. Note that the reports are always generated in a directory called "schemaspy". The output directory refers to the directory in which the "schemaspy" will be generated.
- Type:
java.lang.String
- Required:
No
- User Property:
outputDirectory
- Default:
${project.build.directory}/site
<outputFormat>
The report output format: null by default, to represent a site, but can be configured to a Doxia Sink id.
- Type:
java.lang.String
- Required:
No
- User Property:
output.format
<outputTimestamp>
Timestamp for reproducible output archive entries, either formatted as ISO 8601
yyyy-MM-dd'T'HH:mm:ssXXX
or as an int representing seconds since the epoch (like SOURCE_DATE_EPOCH).- Type:
java.lang.String
- Required:
No
- Default:
${project.build.outputTimestamp}
<password>
Database password to use - defaults to none.
- Type:
java.lang.String
- Required:
No
- User Property:
password
<pathToDrivers>
If specified, SchemaSpy will look for JDBC drivers on this path, rather than using the application classpath. Useful if your database has a non-O/S driver not bundled with the plugin.
- Type:
java.lang.String
- Required:
No
- User Property:
pathToDrivers
<port>
The port, required by some drivers.
- Type:
java.lang.String
- Required:
No
- User Property:
port
<runOnExecutionRoot>
Whether to create the report only on the execution root of a multi-module project.
- Type:
boolean
- Since:
5.0.4
- Required:
No
- User Property:
runOnExecutionRoot
- Default:
false
<schema>
Database schema to use - defaults to the specified user.
- Type:
java.lang.String
- Required:
No
- User Property:
schema
<schemaDescription>
Schema description. Displays the specified textual description on summary pages. If your description includes an equals sign then escape it with a backslash. NOTE: This field doesn't seem to be used by SchemaSpy in the current version.
- Type:
java.lang.String
- Required:
No
- User Property:
schemaDescription
<schemas>
Evaluate specified schemas. Similar to -showAllSchemas, but explicitly specifies which schema to evaluate without interrogating the database's metadata. Can be used with databases like MySQL where a database isn't composed of multiple schemas.
- Type:
java.lang.String
- Required:
No
- User Property:
schemas
<showAllSchemas>
Evaluate all schemas in a database. Generates a high-level index of the schemas evaluated and allows for traversal of cross-schema foreign key relationships. Use with -schemaSpec "schemaRegularExpression" to narrow-down the schemas to include.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
showAllSchemas
<singleSignOn>
Single Sign-On. Don't require a user to be specified with -user to simplify configuration when running in a single sign-on environment.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
singleSignOn
<siteDirectory>
Directory containing the
site.xml
file.- Type:
java.io.File
- Required:
No
- Default:
${basedir}/src/site
<targetDirectory>
The output directory for the intermediate report.
- Type:
java.io.File
- Required:
No
- User Property:
targetDirectory
- Default:
${project.build.directory}
<useDriverManager>
Some databases, like Derby, will crash if you use the old driver object to establish a connection (eg "connection = driver.connect(...)"). In this case, set useDriverManager to true to use the DriverManager.getConnection() method instead (eg "connection = java.sql.DriverManager.getConnection(...)"). Other databases (eg MySQL) seem to only work with the first method, so don't use this parameter unless you have to.
- Type:
java.lang.Boolean
- Required:
No
- User Property:
useDriverManager
<user>
Connect to the database with this user id.
- Type:
java.lang.String
- Required:
No
- User Property:
user
<vizjs>
No description.
- Type:
boolean
- Required:
No
- User Property:
vizjs
- Default:
true