{"title":"Database.SetDefaultTableConnection(TableConnectionType, Text [, Boolean]) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/database/database-setdefaulttableconnection-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/database/database-setdefaulttableconnection-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/database/database-setdefaulttableconnection-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Establishes a connection to an external database based on a previously registered connection of the specified type.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"Database.SetDefaultTableConnection(TableConnectionType, Text [, Boolean]) Method","slug":"databasesetdefaulttableconnectiontableconnectiontype-text-boolean-method","at":0,"chars":1207},{"level":2,"title":"Syntax","slug":"syntax","at":259,"chars":190},{"level":2,"title":"Parameters","slug":"parameters","at":449,"chars":622},{"level":2,"title":"Related information","slug":"related-information","at":1071,"chars":136}],"text":"# Database.SetDefaultTableConnection(TableConnectionType, Text [, Boolean]) Method\n> Version: _Available or changed with runtime version 1.0._\nEstablishes a connection to an external database based on a previously registered connection of the specified type.\n## Syntax\n```al\n Database.SetDefaultTableConnection(Type: TableConnectionType, Name: Text [, Scoped: Boolean])\n```\n> NOTE\n> This method can be invoked without specifying the data type name.\n## Parameters\nType\nType: ../tableconnectiontype/tableconnectiontype-option\nThe type of table connection as defined in the TableType property.\nName\nType: ../text/text-data-type\nThe name of the external table connection. You must already have registered a table connection with this name.\n*[Optional] Scoped*\nType: ../boolean/boolean-data-type\nIf true, when the method ends where you have used SETDEFAULTTABLECONNECTION, the default table connection returns to the value it had before. Use the Scope parameter when you want to use a specific table connection for a specific task and then return to the normal configuration.\n## Related information\ndatabase-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}