Verbinding maken met een database met de MSSQL-extensie voor Visual Studio Code

De MSSQL-extensie voor Visual Studio Code centreert zich rond uw verbindingen met SQL Server, Azure SQL en SQL-database in Microsoft Fabric. In dit artikel leest u hoe u verbindingen maakt met het dialoogvenster Verbinding en welke verificatietypen de extensie ondersteunt. Ook wordt uitgelegd hoe u opgeslagen verbindingen in de Objectverkenner ordent en hoe u de verbinding kiest die door de extensie wordt gebruikt wanneer u een nieuw SQL-bestand opent.

Nadat u verbinding hebt gemaakt, raadpleegt u quickstart: Voer uw eerste query uit met de MSSQL-extensie voor Visual Studio Code om een database te maken, gegevens toe te voegen en Transact-SQL instructies uit te voeren.

Venster voor Verbinding

Het dialoogvenster Verbinding is de primaire manier om een verbinding te maken of te bewerken. Open deze door Verbinding toevoegen te selecteren in het Objectverkenner of door de opdracht MS SQL uit te voeren: opdracht Verbinding toevoegen vanuit het opdrachtpalet.

Het dialoogvenster heeft drie hoofdgebieden:

Een formuliergebied in het midden, waarin u verbindingsdetails invult.
Een deelvenster Opgeslagen verbindingen en recente verbindingen aan de rechterkant, met verbindingen die u snel opnieuw kunt openen of bewerken.
Een voettekst met de acties Geavanceerd, Verbinding testen, Opslaan zonder verbinding te maken en Verbinding maken .

Invoertypen

Boven aan het formulier bepaalt de invoertypekiezer hoe u verbindingsgegevens invoert. Gebruik het invoertype dat het beste overeenkomt met wat u al weet over de doelserver.

Parameters: vul afzonderlijke velden in, zoals servernaam, databasenaam, verificatietype, gebruikersnaam en wachtwoord. Dit invoertype is de standaardinstelling en is de eenvoudigste optie voor de meeste scenario's.
Connection String: Plak een volledige verbindingsreeks in ADO.NET-stijl. Dit invoertype is handig wanneer er al een verbindingsreeks aan u is verstrekt (bijvoorbeeld vanuit de Azure-portal of door een beheerder), of wanneer u opties moet configureren die niet beschikbaar zijn in de weergave Parameters.
Door Azure bladeren: Meld u aan bij Azure en kies een server en database in uw abonnementen. U kunt filteren op abonnement en resourcegroep om de gewenste database te vinden. Deze optie werkt voor Azure SQL Database en Azure SQL Managed Instance (zowel privé- als openbare eindpunten worden vermeld). U kunt favoriete abonnementen toevoegen, zodat ze boven aan de lijst worden weergegeven en automatisch worden geladen.
Blader Fabric: meld u aan bij Microsoft Fabric en kies een SQL-database uit een van uw werkruimten. In het dialoogvenster worden werkruimten weergegeven waar u toegang toe hebt en de SQL-databases erin. Net zoals wanneer u Azure bladert, kunt u uw favoriete werkruimten zo weergeven dat ze boven aan de lijst worden weergegeven en automatisch worden geladen.

Zowel Azure verkennen als Fabric verkennen maken gebruik van de Microsoft-accounts waarmee u zich aanmeldt bij Visual Studio Code. U kunt zich aanmelden met zoveel Microsoft accounts als u wilt en schakelen tussen accounts en hun tenants met behulp van de vervolgkeuzelijsten boven aan het bladervenster. GitHub-accounts kunnen niet worden gebruikt om door Azure en Fabric databases te bladeren.

Een database kiezen

In het veld Database kunt u verbinding maken met de standaarddatabase van de server of met een specifieke database.

Laat het veld ingesteld op <Standaard> om verbinding te maken met de standaarddatabase waaraan de server uw aanmelding toewijst. Dit is de eenvoudigste optie en u kunt later nog steeds overschakelen van databases vanuit de editor.
Selecteer een specifieke database in de vervolgkeuzelijst. Nadat u voldoende gegevens hebt ingevuld om te verifiëren, probeert de extensie de lijst met databases op de server op de achtergrond op te halen. Als de lijst succesvol is geladen, kunt u er een keuze uit maken.
Als de databaselijst niet kan worden geladen, bijvoorbeeld wanneer uw aanmelding geen machtiging heeft om databases op de server op te sommen, kunt u de databasenaam nog steeds rechtstreeks in het veld typen.

Geavanceerde instellingen

Selecteer Geavanceerd in de voettekst om een zijpaneel te openen met de volledige set extra verbindingsopties, zoals Always Encrypted, Time-out voor opdrachten en Toepassingsintentie (alleen lezen of lezen/schrijven). Dit zijn dezelfde opties die u in een verbindingsreeks zou vinden, gegroepeerd in categorieën zoals Beveiliging, Verbindingstolerantie en Pooling. Gebruik het zoekvak boven aan het deelvenster om snel een specifieke instelling te vinden.

De knoppen in de voettekst bepalen wat er gebeurt wanneer u klaar bent met het invullen van het formulier.

Verbinding maken: maakt verbinding met de database en voegt de verbinding toe aan de lijst met opgeslagen verbindingen.
Testverbinding: probeert verbinding te maken met behulp van de huidige formulierwaarden zonder iets op te slaan. Gebruik deze optie om te controleren of de server, referenties en andere instellingen juist zijn voordat u verbinding maakt.
Opslaan zonder verbinding te maken: slaat het verbindingsprofiel op in uw lijst met opgeslagen verbindingen, maar opent geen sessie. Dit is handig wanneer u vooraf verbindingen instelt of als u de naam van een bestaande verbinding wilt wijzigen zonder verbinding te maken.

Werken met bestaande verbindingen

Met de lijsten Opgeslagen verbindingen en recente verbindingen aan de rechterkant van het dialoogvenster kunt u eenvoudig beginnen met een verbinding die u al hebt.

Beweeg de muisaanwijzer over een opgeslagen verbinding om een actiemenu weer te geven. Hier kunt u de details van de verbinding bewerken , een nieuwe verbinding maken op basis van een bestaande verbinding (een handige snelkoppeling wanneer meerdere verbindingen dezelfde server delen, maar verschillende databases of referenties) of de verbinding uit de lijst verwijderen.
Recente verbindingen werken op dezelfde manier, maar zijn beperkt tot verbindingen die u onlangs hebt gebruikt, zelfs als ze niet worden opgeslagen.

Ondersteunde verificatietypen

De MSSQL-extensie ondersteunt verschillende verificatietypen. Kies de server die overeenkomt met de configuratie van uw server.

Voer een gebruikersnaam en wachtwoord in die zijn gedefinieerd op de SQL Server zelf. SQL-aanmelding werkt voor SQL Server, Azure SQL Database en Azure SQL Managed Instance.

U kunt het wachtwoord desgewenst opslaan, zodat u het niet telkens opnieuw hoeft in te voeren wanneer u verbinding maakt.

Windows-authenticatie

Gebruik uw huidige Windows-account om u aan te melden bij de server, zonder gebruikersnaam of wachtwoord vereist. Windows verificatie werkt alleen wanneer u verbinding maakt met een SQL Server exemplaar dat is geconfigureerd om dit te accepteren, meestal op een netwerk dat lid is van een domein of op dezelfde computer als de server.

Deze optie wordt ook wel geïntegreerde verificatie genoemd. Het is niet beschikbaar voor Azure SQL Database, Azure SQL Managed Instance of SQL-database in Fabric.

Microsoft Entra ID - Universeel met MFA

Meld u aan met een Microsoft Entra ID-account. Deze optie ondersteunt meervoudige verificatie (MFA), beleid voor voorwaardelijke toegang en persoonlijke Microsoft-accounts die gasten zijn in een Microsoft Entra tenant.

Wanneer u deze optie selecteert, wordt u in het dialoogvenster gevraagd een Microsoft Entra ID account te kiezen of toe te voegen en een tenant te kiezen als het account toegang heeft tot meer dan één account.

De extensie maakt gebruik van de Microsoft accounts waarmee u zich hebt aangemeld bij Visual Studio Code (dezelfde accounts die worden weergegeven in het menu Accounts in de linkerbenedenhoek van het venster). Als u nog niet bent aangemeld bij Visual Studio Code of de MSSQL-extensie nog geen toestemming hebt gegeven om accounts te gebruiken, wordt u gevraagd om u aan te melden wanneer u verbinding maakt.

Note

Als u zich eerder hebt aangemeld bij de MSSQL-extensie met behulp van het eigen accountsysteem van de extensie (gebruikt in MSSQL 1.42.2 en eerder), wordt u gevraagd u aan te melden bij Visual Studio Code (als u dat nog niet bent) wanneer u de volgende keer verbinding maakt met een van uw opgeslagen verbindingen.

Als het accountsysteem van Visual Studio Code niet voor u werkt, laat het ons weten. U kunt terugvallen op het vorige aanmeldingsmechanisme door mssql.preview.useVscodeAccountsForEntraMFA in te stellen op false.

Microsoft Entra ID - Standaard

Deze optie maakt gebruik van Microsoft Entra ID standaardverificatie. Het MDS-stuurprogramma (Microsoft Data SQL) selecteert automatisch een beschikbare Microsoft Entra ID identiteit van referentieproviders die op uw systeem zijn geïnstalleerd. Dit verificatietype is handig wanneer u specifieke verificatievereisten hebt die niet rechtstreeks worden ondersteund door de MSSQL-extensie.

Identiteiten kunnen afkomstig zijn van verschillende bronnen, zoals een aangemelde Azure CLI sessie (az login) of omgevingsvariabelen, en u kunt een specifieke identiteit instellen om te worden gebruikt door het User name vak in te stellen. Zie DefaultAzureCredential in de Azure Identity-clientbibliotheek voor meer informatie over hoe standaardverificatie een identiteit selecteert

Microsoft Entra ID - Service Principal

Meld u aan als een Microsoft Entra ID service-principal (een toepassingsidentiteit in plaats van een gebruiker). Gebruik deze optie voor automatiseringsscenario's, gedeelde werkstations of elk geval waarin het beter is om databasetoegang te verlenen tot een toepassingsidentiteit in plaats van een persoon.

Wanneer u deze optie selecteert, worden de velden Gebruikersnaam en Wachtwoord opnieuw gebruikt:

Voer de toepassings-id (client) van de service-principal in als gebruikersnaam.
Voer het clientgeheim van de service-principal in als het wachtwoord.

Zie Service-principal in de Azure Identity-clientbibliotheek voor meer informatie over het gebruik van een service-principal met SQL

Verbindingen in de Objectverkenner

Elke verbinding die u maakt vanuit het dialoogvenster Verbinding (of u nu direct verbinding maakt of opslaat zonder verbinding) wordt weergegeven in de Objectverkenner in de MSSQL-weergave. In het Objectverkenner gaat u naar de inhoud van de server, voert u acties zoals back-ups uit en maakt u opnieuw verbinding met databases die u eerder hebt gebruikt.

Verbindingsgroepen

Verbindingen kunnen worden ingedeeld in verbindingsgroepen. Groepen fungeren als mappen: u kunt ze een naam geven, een kleur toewijzen en verbindingen erin plaatsen om omgevingen visueel gescheiden te houden (bijvoorbeeld Productie, Fasering en Lokaal).

Een groep maken: gebruik de opdracht Nieuwe verbindingsgroep of wijs een nieuwe groep toe tijdens het maken of bewerken van een verbinding.
Slepen en neerzetten om te organiseren: Sleep een verbinding naar een groep om de verbinding naar die groep te verplaatsen. Sleep een groep naar een andere groep om deze te nesten. U kunt geneste groepen maken met meerdere niveaus.
Uitvouwen en samenvouwen: Gebruik de punthaken naast elke groep om deze uit te vouwen en samen te vouwen, zodat u alleen de verbindingen ziet waarmee u momenteel werkt. Als u altijd wilt beginnen met groepen die zijn samengevouwen wanneer Visual Studio Code wordt gestart, schakelt u de mssql.collapseConnectionGroupsOnStartup instelling in.

Klik met de rechtermuisknop op een serververbinding in de Objectverkenner om acties te zien die van toepassing zijn op de verbinding zelf. De meest gebruikte verbindingsgerelateerde opties zijn:

Verbinding / Verbinding verbreken: een sessie starten of beëindigen op de server.
Verbinding bewerken: open het dialoogvenster Verbinding met het verbindingsprofiel dat is geladen om de parameters te bewerken.
Verbindingsreeks kopiëren: Kopieer een verbindingsreeks van de opgeslagen verbinding naar uw klembord. Dit is handig wanneer u de verbinding wilt delen met een ander hulpprogramma of deze in de toepassingscode wilt plakken. Wachtwoorden en geheimen zijn niet opgenomen.
Verbinding verwijderen: verwijder de verbinding uit de opgeslagen lijst.

Firewallregels voor Azure SQL

Wanneer u verbinding maakt met een Azure SQL Database of Azure SQL Managed Instance vanaf een client-IP-adres dat niet is toegestaan door de firewall van de server, kunt u de MSSQL-extensie gebruiken om een firewallregel toe te voegen via het dialoogvenster Firewallregel toevoegen.

Meld u in het dialoogvenster Firewallregel toevoegen aan met een Microsoft-account die gemachtigd is om de server te beheren, geef de regel een naam en kies of u alleen uw huidige IP-adres of een bereik wilt toestaan. Nadat u de regel hebt opgeslagen, wordt de verbinding automatisch opnieuw geprobeerd.

Verbindingen met werkruimte

Opgeslagen verbindingen en verbindingsgroepen worden opgeslagen in uw Visual Studio Codesettings.json. De extensie leest verbindingen uit twee machtigingsbereiken:

Gebruikersinstellingen (globaal): Nieuwe verbindingen worden hier opgeslagen. Ze zijn beschikbaar in al uw Visual Studio Code sessies, ongeacht welke map is geopend.
Werkruimte-instellingen: verbindingen die zijn opgeslagen op werkruimteniveau zijn alleen beschikbaar wanneer die werkruimte is geopend. Dit bereik is handig voor projectspecifieke verbindingen die u wilt delen met samenwerkers door het werkruimtebestand .code-workspace in broncodebeheer te controleren.

Als u een verbinding wilt verplaatsen van gebruikersinstellingen naar werkruimte-instellingen, kopieert u de JSON-vermelding van de verbinding van uw gebruiker settings.json naar de werkruimte settings.jsonen verwijdert u deze uit de gebruikersconfiguratie.

Note

De extensie leest geen verbindingen uit de instellingen van afzonderlijke werkruimtemappen (de instellingen per map .vscode/settings.json binnen een werkruimte met meerdere hoofdmappen). Als u een verbinding wilt toepassen op een specifiek project, slaat u deze op werkruimteniveau op.

Wanneer u een verbinding met een wachtwoord of geheim opslaat, wordt het bijbehorende wachtwoord niet opgeslagen in settings.json. Wachtwoorden worden afzonderlijk bewaard in het beveiligde referentiearchief van Visual Studio Code.

Verbindingsselectie bij het openen van een nieuw SQL-bestand of -editor

Wanneer u een .sql bestand opent of een nieuwe SQL-editor maakt, kan de extensie de verbinding met de editor verbreken of automatisch verbinding maken.

Dit gedrag wordt bepaald door de mssql.newEditorConnectionBehavior instelling, die ondersteuning biedt voor drie modi:

Wijze	Description
`none`	Nieuwe SQL-editors worden geopend zonder verbinding. U wordt gevraagd om een verbinding te kiezen wanneer u voor het eerst een query uitvoert, of u kunt de OPDRACHT SQL: Verbinding maken gebruiken om handmatig een verbinding te koppelen.
`transferActive` (standaard)	Nieuwe SQL-editors worden automatisch verbonden met dezelfde database als uw momenteel actieve SQL-editor. Dit is handig wanneer u aan meerdere bestanden met dezelfde database werkt en niet opnieuw verbinding wilt maken met elke database. Als er momenteel geen SQL-editor actief is, wordt de nieuwe editor geopend zonder verbinding.
`defaultConnection`	Nieuwe SQL-editors worden automatisch verbonden met een specifieke verbinding die u als standaardverbinding hebt aangewezen. De standaardverbinding wordt geïdentificeerd door de `mssql.defaultConnectionId` instelling. Als u deze modus wilt gebruiken, moet u `mssql.defaultConnectionId` ook instellen op de ID van een van uw opgeslagen verbindingen. U kunt de id vinden door uw opgeslagen verbindingen te bekijken in `settings.json`. Als `mssql.defaultConnectionId` deze niet is ingesteld of niet meer overeenkomt met een opgeslagen verbinding, wordt u door de extensie gevraagd een standaardverbinding te kiezen wanneer u de volgende keer een nieuwe SQL-editor opent.

U kunt deze instellingen wijzigen vanuit de gebruikersinterface van de Visual Studio Code-instellingen door te zoeken naar mssql.newEditorConnectionBehavior of mssql.defaultConnectionId.

Feedback

Is deze pagina nuttig?

Last updated on 2026-06-23