Viewing table data
For developers, administrators, and support personnel, it can be useful to inspect table data in the tenant database, particularly when debugging or troubleshooting. To support this need, you can view table objects in the Web client. This lets you see the data in all rows and columns of a specific table, including any columns that are added by table extensions.
In a production environment, administrators and support can view a table directly from the Web client.
From the Business Central administration center, you can launch a list of all tables, sorted by storage size. For more information, see Storage usage by environment.
In a development environment, in addition to viewing a table directly from the Web client, developers can view a table automatically when they publish/debug an AL project from Visual Studio Code.
Note
The table appears as read-only in the client, so modifications, insertions, and deletions cannot be made.
Important
Data in the tables can be sensitive. Make sure that you follow your organization's guidelines for handling such data.
Required permissions
Whether viewing the table directly from the client or from Visual Studio Code, your Dynamics 365 user account must have the following permissions:
- Read permission on the table that you want to view.
- Execution permission (direct) on the System object 1350 Run table.
Any end-user that is assigned these permissions will be able to view that table in the browser.
For information about assigning permissions, see Manage Users and Permissions.
View a table object directly from the client
To view a table, you add the table=<TableID>
parameter to the client's address (URL), replacing <TableID>
with the ID of the table that you want to view.
For example, if your URL starts with https://businesscentral.dynamics.com
, then to view table 18 Customer in your current company, you could use the following URL:
https://businesscentral.dynamics.com/?table=18
Or, for a specific company, such as "CRONUS Inc.":
https://businesscentral.dynamics.com/?company=CRONUS%20Inc.&table=18
Note the use of &
when table=<TableID>
isn't located directly after the domain name.
View a table object from an AL project in Visual Studio Code
You can configure an AL project to view a table when you publish or debug the project (selecting F5 or Ctrl+F5 ).
In the launch.json
file for the project, set the "startupObjectType"
parameter to "table"
and the "startupObjectId"
parameter to the ID of the table. For example:
{
"version": "1.0.0",
"configurations": [
{
"name": "Your own server",
"request": "launch",
"type": "al",
"environmentType": "OnPrem",
"server": "http://localhost",
"serverInstance": "BC",
"authentication": "Windows",
"startupObjectId": 18,
"startupObjectType": "Table",
"launchBrowser": true,
"enableLongRunningSqlStatements": true,
"enableSqlInformationDebugger": true,
"numberOfSqlStatements": 10,
"tenant": "default",
"usePublicURLFromServer": true
}
]
}
For more information about the launch.json
file, see Launch JSON file.
Constraints
You cannot view virtual tables or the following system tables:
ID | Name |
---|---|
2000000170 | Configuration Package File |
2000000173 | Data Sensitivity |
2000000100 | Debugger Breakpoint |
2000000103 | Debugger Watch |
2000000130 | Device |
2000000114 | Document Service |
2000000190 | Entitlement Set |
2000000191 | Entitlement |
2000000180 | MediaSet |
2000000181 | Media |
2000000195 | Membership Entitlement |
2000000162 | Nav App Capabilities |
2000000152 | Nav App Data Archive |
2000000161 | Application Dependency (*Nav App Dependencies) |
2000000150 | Application Object Metadata (*Nav App Object Metadata) |
2000000163 | Nav App Object Prerequisites |
2000000142 | Application Resource (*Nav App Resource) |
2000000151 | Installed Application (*Nav App TenantApp) |
2000000160 | Published Application (*Nav App) |
2000000071 | Object Metadata |
2000000079 | Object Tracking |
2000000001 | Object |
2000000198 | Page Documentation |
2000000186 | Profile Page Metadata |
2000000082 | Report Layout |
2000000065 | Send To Program |
2000000112 | Server Instance |
2000000066 | Style Sheet |
2000000197 | Token Cache |
2000000081 | Upgrade Blob Storage |
2000000121 | User Property |
2000000076 | Web Service |
2000000194 | Webhook Notification |
2000000199 | Webhook Subscription |
Note
The tables marked with * in the table above changed names with Business Central 2020 release wave 1. For more information, see Deprecated Tables.