Chat now with support
Chat with Support

Toad Data Modeler 7.2 - User Guide

Introduction User Interface Models and Model Objects
Physical Data Model
Entity Relationship Diagram Objects Basic Database Design Advanced Database Design
Universal Data Model Logical Data Model Working with Model Objects
Features and Tools
Application Variables Export/Import DDL Script Generation Graphics Model Actions Print Create New Project Reports Reverse Engineering Scripting and Customization About Templates Tips and Tricks Toad for Oracle Integration Toad Intelligence Central (TIC) Integration Tools Version Control
Options and Configuration Databases
Amazon Redshift 1.0 IBM DB2 LUW 9.5 IBM DB2 LUW 9.7 IBM DB2 LUW 10.1 IBM DB2 LUW 10.5 IBM DB2 LUW 11.1 IBM DB2 z/OS 10 IBM DB2 z/OS 11 Greenplum 4.1 Greenplum 4.2 Ingres 9.3 Ingres 10.0 EDB Postgres Advanced Server 10 Microsoft Access 2007/2010 Microsoft Azure SQL Database V12 Microsoft SQL Server 2005 Microsoft SQL Server 2008 Microsoft SQL Server 2012 Microsoft SQL Server 2014 Microsoft SQL Server 2016 Microsoft SQL Server 2017 Microsoft SQL Server 2019 MySQL 5.0 MySQL 5.1 MySQL 5.5 MySQL 5.6 MySQL 5.7 MySQL 8.0 Oracle 10g Oracle 11g Release 1 Oracle 11g Release 2 Oracle 12c Release 1 Oracle 12c Release 2 Oracle 18c Oracle 19c PostgreSQL 9.0 PostgreSQL 9.1 PostgreSQL 9.2 PostgreSQL 9.3 PostgreSQL 9.4 PostgreSQL 9.5 PostgreSQL 10 PostgreSQL 11 PostgreSQL 12 SQLite 3.7 Sybase ASE 15.5 Sybase ASE 15.7 SAP ASE 16.0 Sybase IQ 15.2 Sybase SQL Anywhere 11 SAP SQL Anywhere 17 Teradata 13 Vertica Database 8.0
Copyright Legal Notices

Create Entities

In Toad Data Modeler, there are several ways how to create entities - on the Workspace, via Model Explorer and in the Entities dialog (Model | Model Items | Entities). Create entities directly on the Workspace.


Create entity Customer on the Workspace in your Videorental model.

  1. Click on the toolbar (also CTRL+E) and then click anywhere on the Workspace.
  2. Double-click the entity to edit it.
  3. Define the entity caption and name


Logical entity name - Customer.

Name Physical entity name - T_CUSTOMER.
  1. Define other properties on tab General and other tabs (e.g. Notes, Comments etc.). To save the changes simultaneously and leave the form open, click Apply.

Create Attributes

You can create attributes in:

  • Entity right-click menu on Workspace
  • Entity Properties dialog
  • Attribute Properties dialog
  • Model Explorer

To create an attribute on the Workspace

Right-click an entity on the Workspace and select Add | Attribute. The Attribute Properties dialog opens.

Note: Select the Primary Key (Unique) checkbox to set the attribute as PK or unique attribute.

To create an attribute in the Entity Properties form

  1. Double-click an entity on Workspace.
  2. In the Entity Properties form, switch to the Attributes tab and click Add.

Entity Properties attribute columns

Column/Option Description


Graphical representation of keys of a particular attribute


Logical attribute name


Physical attribute name

Data Type

Data Type of an attribute

TIP: You can set a default data type for newly created attributes. See Settings Menu | Options | Physical Model | *database platform and version* | Default Data Type combo-box. (The selected data type will be also applied to Dictionary Types and Domains.)


Parameter 1. Only some of the available data types have this parameter. Defines properties of the selected data type, e.g. length in case of the Char data type.


Parameter 2. Only some of the available data types have two parameters. E.g. the Decimal data type has two parameters, which define precision and scale.

Not Null

When checked, the attribute cannot be empty.


Comments or descriptions related to the attribute


Shows status of attributes in grid. Status of Items in Grids


- opens the Application Variables form

Smaller Add button- adds new attributes quickly, just enter attribute name and then click Add.

Bigger Add button - adds an attribute

Edit - opens Attribute Properties of the selected entity

Delete - deletes the selected attribute

- moves the selected attribute up or down in the list

To create another attribute in the Attribute Properties form

Click OK+Add.

To create an attribute in Model Explorer

Unfold the Entities folder | Unfold the specific entity folder | Right-click the Attributes folder | Add Attribute.

Create Primary Key

An entity can have a primary key and many alternate keys. The keys are stored in the Keys tab in the Entity Properties form.

To create a key

  • Right-click an entity on the Workspace and select Add | Key. The Key Properties dialog opens.

To create a PK (unique) attribute

  1. Right-click an entity on the Workspace and select Add | Attribute. The Attribute Properties dialog opens.
  2. On tab General, select the Primary Key (Unique) checkbox.

To assign an attribute to key

  • In the Entity Properties dialog, Attributes tab, double-click the empty space in the Key column next to the selected attribute.


  • In the Key Properties dialog | Attributes tab.


  • Primary keys are graphically marked by red key by default.
  • A primary key can be added to more attributes.
  • It is possible to delete primary keys. It is not possible to delete alternate keys of unique attributes.

NotNull Property for PK and AK Attributes

Toad Data Modeler allows you to check/uncheck the NotNull property for PK and AK attributes.This is possible only if the Allow Null Attributes in Keys checkbox is selected (unchecked by default).

To select this checkbox

Select Settings | Options | Physical Model and select the checkbox.

If this checkbox is not selected, Toad Data Modeler doesn’t allow you to uncheck the NotNull checkbox in key attributes.

The availability of this option differs by database:

Database Allow NULL in PK Allow NULL in AK
DB2 z/OS v. 9, 10, 11 n/a n/a
DB2 v. 8, 9.x, 10.x n/a n/a
Greenplum n/a available
Ingres 9.3, 10 n/a n/a
Microsoft Access available available
Microsoft Azure SQL Database n/a available
SQL Server 2000 n/a n/a
SQL Server 2005 n/a available
SQL Server 2008 n/a available
SQL Server 2012 n/a available
SQL Server 2014 n/a available
MySQL 5.x n/a available
Oracle available available
PostgreSQL n/a available
SQLite 3.7 available available
Sybase ASE, Sybase IQ n/a n/a
Sybase SQL Anywhere n/a n/a
Teradata n/a n/a

If the Allow Null Attributes in Keys checkbox is selected:

  • When you assign an attribute to a key (PK, AK), the Not Null checkbox of the attribute will be checked. (But you are able to uncheck it)
  • During propagation of the key via the identifying relationship, the Not Null property in child attribute is inherited from the parent attribute. The only exception is when a database doesn't support Null value in primary key, which would be created via the propagation.
  • During Model Conversion, different settings of the Not Null property and its support in different databases are taken into consideration.
  • For databases that support Null value in child attribute, the Mandatory Parent checkbox is selected in the Relationship Properties dialog and should behave coherently to Null value in child attribute as well as it behaves for non-identifying relationships.
  • For databases that support Null value in child attribute, the settings of the Synchronize NotNull with Mandatory Parent option work the same way for PFK as for FK.

See Synchronization of NotNull and Mandatory Parent for more information.

Create Relationship

  1. Select a relationship type - click the appropriate relationship icon on the toolbar:

 Identifying relationship (also CTRL+R)

 Non-identifying relationship

   M:N relationship

  1. Move your mouse cursor over the work area. (The cursor changes its appearance.)
  2. Click the first entity (parent) and then the target entity (child).

TIP: Hide relationship names:

  1. Right-click the Workspace and select Workspace Format.
  2. In the Workspace Format dialog | General tab, select Hide Line Captions checkbox.

To create self-relationship for non-identifying relationship

  1. Click the Non-identifying relationship icon on the toolbar .
  2. Move your mouse cursor over the work area.
  3. Double-click the selected entity on the Workspace.

TIP: Before you create a self-relationship, select Settings | Options | Physical Model | Self Relation Attribute Name/Caption and define a name for propagated attributes there (e.g. via prefix, suffix, application variable.)

To add multiple relationships

  1. Press SHIFT and click the Relationship icon. See the blue frame in the icon now.
  2. Create as many relationships in you model as you need.
  3. Right-click the work area (or click the Relationship icon again) to turn this function off.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating