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:

IDName
2000000170Configuration Package File
2000000173Data Sensitivity
2000000100Debugger Breakpoint
2000000103Debugger Watch
2000000130Device
2000000114Document Service
2000000190Entitlement Set
2000000191Entitlement
2000000180MediaSet
2000000181Media
2000000195Membership Entitlement
2000000162Nav App Capabilities
2000000152Nav App Data Archive
2000000161Application Dependency (*Nav App Dependencies)
2000000150Application Object Metadata (*Nav App Object Metadata)
2000000163Nav App Object Prerequisites
2000000142Application Resource (*Nav App Resource)
2000000151Installed Application (*Nav App TenantApp)
2000000160Published Application (*Nav App)
2000000071Object Metadata
2000000079Object Tracking
2000000001Object
2000000198Page Documentation
2000000186Profile Page Metadata
2000000082Report Layout
2000000065Send To Program
2000000112Server Instance
2000000066Style Sheet
2000000197Token Cache
2000000081Upgrade Blob Storage
2000000121User Property
2000000076Web Service
2000000194Webhook Notification
2000000199Webhook 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.

Developing Extensions
Deprecated Tables
Managing Capacity