---
sourceDocument: Zurich Platform Analytics
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/now-intelligence

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Add a table to the semantic data layer

# Add a table to the semantic data layer {#ariaid-title1}

* Release version: Zurich
* 
* Updated July 31, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

Add more tables to the Query Generation semantic layer so that users can use ServiceNow Otto for Platform Analytics applications to ask questions about the data in those tables.

## Before you begin

Semantic table configuration supports regular tables, database views, and Workflow Data Fabric tables.  
Warning:  
Adding a table to the semantic data layer and enabling semantic generation on that table can negatively impact both initial load time and runtime performance of Query Generation.

Role required: sn_query_gen.admin or higher

## Procedure

1. Navigate to AllQuery GenerationAdministrationSemantic table config.  
   If you do not have this navigation path despite having the correct roles, you may be missing a required entitlement.  
   Note:  
   As an alternative to this procedure, you can select one or more tables in a list and apply the Enable for Query Generation list action.  

2. In the Semantic Tables Configurations list, select New.
3. Set your session application scope to be the same as the scope you want for the table.  
   Important:  
   To add a database view, you must select the same scope as that database view.
4. Select a table from the Table Name list.
5. Select whether to enable semantic generation for the table.  
   By default, semantic generation is enabled. For more information, see [Enable semantic generation for tables in the semantic layer](https://www.servicenow.com/docs/~UvxkhmeBtM8D5JgYAaW9A "Tables can be included in the semantic table configuration but have semantic generation turned off. Enable semantic generation to include that table in Query Generation. Deactivate irrelevant data to improve results.").
6. Select whether to include the hierarchy of child tables.  
   By default, child hierarchies are included.
7. Select Submit.

## Result

Your table is added to the list. If you enabled semantic generation, records for the table and its child tables, if included, are generated in the Entities \[sn_query_gen_entities\] table. Records for the table columns are
generated in the Dimensions \[sn_query_gen_dimensions\] table.

## Adding the Contract table hierarchy to the semantic layer {#add-table-semantic-layer__example_gfb_c5m_bgc}

If you have users who need to explore and discuss data relating to asset contracts, add the Contract \[ast_contract\] table to the semantic layer. This table hierarchy is not supported by default.  
1. First, you open the Semantic Table Configuration list \[sn_query_gen_table_config_list\] and press the New button.

2. Now you are in the form for creating a new Semantic Table Configuration record. You search for the Contract \[ast_contract\] table and select it.

3. You want to enable semantic generation on the entire Contract table hierarchy, so you leave the Enable Semantic Generation and Include Child Hierarchy checkboxes selected and press Submit.

4. You see that the Contract \[ast_contract\] table has been added to the Semantic Table Configurations table, and that semantic generation is enabled on its hierarchy.

5. When you open the Entities list \[sn_query_gen_entity_list\], you see that the Contract table and all its children are represented by Entity records, and all the records are active.

6. Looking in the Dimensions list \[sn_query_gen_dimension_list\], you see that many columns of the Contract table are represented, and you are confident that you have successfully added the table hierarchy to the semantic layer.

{#add-table-semantic-layer__ol_fqw_kym_bgc}

## Add a batch of tables to the semantic layer {#ariaid-title2}

Instead of adding individual tables or database views to the semantic layer, you can select multiple ones from a list and enable Query Generation for them together.

### Before you begin

Role required: admin, now_assist_explorer_admin, sn_query_gen.admin

### Procedure

1. Navigate to the Tables list \[sys_db_object_list\], the Database Views list \[sys_db_view_list\], or a subset of one of those lists, such as Remote Tables.
2. Set your session application scope, which will be reflected in the scopes of the Semantic Table Configuration records you create.  
   Important:  
   To add a database view, you must select the same application scope as that database view.
3. Select the checkboxes for the desired tables or database views.  
4. Expand Actions on selected rows...
5. Select Enable for Query Generation.  
   When successful, a banner says Selected tables have been successfully added to Query Generation semantic layer. View.
6. Select View to see a list of the tables or database views you just added to Semantic Table Configurations.  
   You can disable semantic generation for any of the tables/database views or add support for their child hierarchies. You can also remove the tables/database views from Semantic Table Configurations.

*[\>]: and then