Database Cache - Teradata Studio

Teradata® Studio™ User Guide

Product
Teradata Studio
Release Number
16.20
Published
September 2019
Language
English (United States)
Last Update
2019-10-10
dita:mapPath
pfg1542649412202.ditamap
dita:ditavalPath
ft:empty
dita:id
B035-2041
lifecycle
previous
Product Category
Teradata Tools and Utilities
Use the Database Cache option to designate specific databases or users to be cached. A database cache file is created to store the metadata that describes information about the database, such as its tables, columns, constraints, indexes, macros, parameters, stored procedures, user-defined functions, user-defined types, and views. This metadata populates the Data Source Explorer and Transfer View views.
The Database Cache option is associated with the Connection Profile. Deleting a Connection Profile also deletes the Database Cache list and any database cache files that were created.

Database Cache Inheritance

If the Data Source Explorer Load option is set to show databases in hierarchical format, child databases and user objects are nested under the parent database or user object. When you select a database or user object to be cached, all of its child database and user objects are also cached. When you change the Data Source Explorer Load option, the database cache is deleted and then re-cached using the new selections.

Progress Monitor

When you first connect to the database and open the Databases folder, the database cache file is created in a background job. To view the progress of the database cache job:
  • Select Window > Show View > Other > General > Progress.
  • Click OK.
As a result of a behavioral change of Progress Monitor with Oxygen framework, the Preferences setting Always run in background is checked by default and Progress Monitor is minimized. To view the progress:
  1. Select Windows > Preferences.
  2. Select General.
  3. Clear the Always run in background check box.
  4. Click Apply and Close.

About Refreshing Cache

After the cache is created, click Refresh to load the cached databases from the database cache file. Cached databases are identified with the cache icon "" .

If new database objects are modified in the database while they are loaded from the database cache, the modified objects do not appear in the Data Source Explorer until you refresh the database cache. To refresh the database cache for a specific database, right-click the cached database and select . This action deletes the database cache file, launches a new background job to create a new database cache file, and refreshes the list of databases.

You can also refresh the database cache by deleting the database cache files in the Teradata JDBC Connection Properties dialog. The Data Source Explorer shows any changes to the database objects. A subsequent refresh of the Databases folder loads the database from the database cache file.

Termination of Cache Job

Terminating the database cache job deletes the database cache files and databases to be loaded from the database metadata. To restart the database cache job, you must disconnect and reconnect the Connection Profile, then click the Databases folder to open it and create the database cache files.