Change the schema name for Jira database tables

Still need help?

The Atlassian Community is here for you.

Ask the community

Symptoms

There are times when an administrator might want to change the schema of their existing database tables.  This could be for organizational or "good practice" purposes.  Other times it may relate to bugs, for example:

JRA-25270 - Getting issue details... STATUS

Verification

This article only applies to Oracle and SQL Server database management systems.

Resolution

Backup XML Restore

Restore XML backup into a brand new database where your db user uses a different schema (e.g. jiraschema).

  1. Backup your existing data via a backup XML: Backing Up Data
  2. Create the new schema in your database
  3. Define the new schema in dbconfig.xml: JIRA Home Directory
  4. Restart JIRA
  5. You should reach the setup wizard, at which point you can restore the Backup XML: Restoring Data

OR

Alter existing Tables for new Schema in Microsoft SQL Server

Always back up your data before performing any modification to the database. If possible, try your modifications on a test server.

  1. Shutdown JIRA
  2. Run the following SQL query in SQL Server:

    SELECT 'ALTER SCHEMA newschema TRANSFER ' + TABLE_SCHEMA + '.' + TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'oldschema'
    1. Replace newschema and oldschema with the actual names of your new and old schema.
    2. This essentially provides a list of SQL queries to help automate the ALTER SCHEMA function in SQL Server
  3. Copy the results into a new SQL script and run the queries.
  4. Define the new schema in dbconfig.xml: JIRA Home Directory
  5. Restart JIRA

 

Last modified on Sep 25, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.