Modeloplossingen implementeren met behulp van de implementatiewizard

Van toepassing op: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

De sql Server Analysis Services-implementatiewizard maakt gebruik van JSON-uitvoerbestanden die zijn gegenereerd op basis van een SQL Server Analysis Services-project als invoerbestanden. Deze invoerbestanden kunnen eenvoudig worden gewijzigd om de implementatie van een SQL Server Analysis Services-project aan te passen. Het gegenereerde implementatiescript kan vervolgens onmiddellijk worden uitgevoerd of opgeslagen voor latere implementatie.

De implementatiewizard/hulpprogramma is geïnstalleerd met SQL Server Management Studio (SSMS). Zorg ervoor dat u de nieuwste versie gebruikt. Als deze wordt uitgevoerd vanaf de opdrachtprompt, wordt standaard de nieuwste versie van de implementatiewizard geïnstalleerd in C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

U kunt deze implementeren met behulp van de wizard, zoals hier wordt beschreven. U kunt ook de implementatie automatiseren of de synchronisatiemogelijkheid gebruiken. Als de geïmplementeerde database groot is, kunt u overwegen partities op doelsystemen te gebruiken. U kunt het maken van partities en populaties automatiseren met behulp van Tabular Object Model (TOM), Tabular Model Scriting Language (TMSL) en Analysis Management Objects (AMO).

De implementatiewizard uitvoeren

De implementatiewizard kan op de volgende manieren worden uitgevoerd:

• Interactief : wanneer deze interactief wordt uitgevoerd, genereert de wizard Implementatie een implementatiescript op basis van de invoerbestanden, zoals interactief gewijzigd door gebruikersinvoer. De wizard past wijzigingen van gebruikers alleen toe op het implementatiescript. De wizard wijzigt de invoerbestanden niet.

• Vanaf de opdrachtprompt - Wanneer de opdrachtprompt wordt uitgevoerd, genereert de implementatiewizard een implementatiescript op basis van de schakelopties die u gebruikt om de wizard uit te voeren. De wizard kan een van de volgende opties hebben: u vragen om gebruikersinvoer en invoerbestanden te wijzigen op basis van die invoer; voer een stille, onbeheerde implementatie uit met behulp van de invoerbestanden zoals is; of maak een implementatiescript dat u later kunt gebruiken.

Interactief uitvoeren

Wanneer de implementatiewizard interactief wordt uitgevoerd, worden de waarden uit de invoerbestanden gelezen en worden deze gegevens aan u gepresenteerd. U kunt deze invoerwaarden wijzigen, zoals de implementatiebestemming, configuratie-instellingen, implementatieopties en verbindingsreekswachtwoorden, of u kunt ze ongewijzigd laten. Als u invoerwaarden wijzigt, gebruikt de wizard deze wijzigingen bij het genereren van het implementatiescript. De wizard brengt echter geen wijzigingen aan in de waarden in het invoerbestand.

Nadat u de invoerwaarden hebt bekeken en gewenste wijzigingen hebt aangebracht, genereert de wizard het implementatiescript. U kunt dit implementatiescript direct uitvoeren op de doelserver of het script opslaan voor later gebruik.

De Wizard voor de implementatie van Analysis Services interactief uitvoeren

• Klik op Start en typ vervolgens Analysis Services-implementatiewizard.

  – of –

• Dubbelklik in de map Projecten van het SQL Server Analysis Services-project op de <projectnaam.asdatabasebestand>.

  Opmerking

  Als u het .asdatabase-bestand niet kunt vinden, gebruikt u Zoeken en geeft u *.asdatabase op. Of mogelijk moet u het project bouwen in SSDT.

Uitvoeren op de opdrachtprompt

De implementatiewizard kan ook worden uitgevoerd bij de opdrachtprompt. Wanneer u de opdrachtprompt uitvoert, geeft u het volledige pad naar het .asdatabase-bestand op en voert u de wizard uit in één van de volgende modi:

Antwoordbestandsmodus
In de antwoordbestandsmodus kunt u met de wizard interactief de invoerbestanden wijzigen die oorspronkelijk zijn gegenereerd toen het SQL Server Analysis Services-project werd gebouwd in SQL Server Data Tools. De wizard slaat deze gewijzigde invoerbestanden op voordat het implementatiescript wordt gegenereerd. De gewijzigde invoerbestanden worden het nieuwe beginpunt wanneer de wizard de volgende keer wordt uitgevoerd.

Gebruik de schakeloptie /a om de wizard uit te voeren in de antwoordbestandsmodus.

Stille modus
In de stille modus voert de wizard een stille, onbeheerde implementatie uit op basis van de informatie die zich in de invoerbestanden bevindt.

Als u de wizard in de stille modus wilt uitvoeren, gebruikt u de schakeloptie /s . Wanneer u de wizard in de stille modus uitvoert, worden berichten verzonden naar de console of naar een logboekbestand als er een is opgegeven.

Uitvoermodus
In de uitvoermodus genereert de wizard een implementatiescript voor latere uitvoering op basis van de invoerbestanden.

Als u de wizard wilt uitvoeren in de uitvoermodus, gebruikt u de schakeloptie /o en geeft u een naam op voor het uitvoerbestand.

Zie Modeloplossingen implementeren met het implementatiehulpprogramma voor meer informatie over deze opdrachtregelswitches.

Voer de implementatiewizard voor Analysis Services uit via de opdrachtprompt

1. Als SSMS 18.x is geïnstalleerd, opent u een opdrachtprompt en navigeert u naar het standaardpad C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

2. Typ Microsoft.AnalysisServices.Deployment.exe gevolgd door de schakelopties die overeenkomen met de modus waarin u de wizard wilt uitvoeren.

Informatie over het implementatiescript

Het XMLA-implementatiescript dat door de implementatiewizard wordt gegenereerd, bestaat uit twee secties:

• Het eerste deel van het implementatiescript bevat de opdrachten die nodig zijn om de juiste Microsoft SQL Server-objecten in de doeldatabase te maken, te wijzigen of te verwijderen. De invoerbestanden die door het SQL Server Analysis Services-project worden gegenereerd, zijn standaard gebaseerd op een incrementele implementatie. Als gevolg hiervan heeft het XMLA-implementatiescript alleen invloed op de objecten die zijn gewijzigd of verwijderd.

• Het tweede deel van het implementatiescript bevat de opdrachten die vereist zijn om alleen de objecten te verwerken die zijn gemaakt of gewijzigd op de doelserver (de optie Standaardproces) of om de doeldatabase volledig te verwerken. U kunt er ook voor kiezen dat het implementatiescript geen verwerkingsopdrachten bevat.

Het volledige implementatiescript kan worden uitgevoerd in één transactie of in meerdere transacties. Als het script in meerdere transacties wordt uitgevoerd, wordt het eerste deel van het script uitgevoerd als één transactie en wordt elk object verwerkt in een eigen transactie.

Implementatiescriptbestanden - Invoer die wordt gebruikt voor het maken van een implementatiescript

Wanneer u een project bouwt, genereert SQL Server Data Tools bestanden voor het project. SQL Server Data Tools plaatst deze bestanden vervolgens in de uitvoermap van het project. Standaard wordt de uitvoer in de map \Bin geplaatst. De volgende tabel bevat de XML-bestanden die sql Server Data Tools maakt:

SQL Server Data Tools slaat nooit wachtwoorden op in de projectbestanden.

Invoerbestanden wijzigen

Als u de waarden in de invoerbestanden wijzigt of de waarden die zijn opgehaald uit de invoerbestanden, kunt u het implementatiedoel, de configuratie-instellingen en implementatieopties wijzigen zonder het hele <projectnaam.asdatabasebestand> te bewerken (of een heel scriptbestand als u een script genereert op basis van een bestaande SQL Server Analysis Services-database). Als u afzonderlijke bestanden kunt wijzigen, kunt u eenvoudig verschillende implementatiescripts maken voor verschillende doeleinden.

Implementatiescriptbestanden - Het installatiedoel opgeven

De implementatiewizard leest de installatie doelinformatie uit het <project name>.deploymenttargets bestand. Sql Server Data Tools maakt dit bestand wanneer u het project bouwt. SQL Server Data Tools gebruikt de database en server die zijn opgegeven op de pagina Implementatie van het dialoogvenster <projectnaam>Eigenschappen om het <projectnaam.targets-bestand> te maken.

Het installatiedoel wijzigen

In sommige situaties moet u mogelijk een project implementeren in een database of exemplaar dat anders is dan het exemplaar dat is opgegeven op de pagina Implementatie . U kunt bijvoorbeeld het project implementeren op een server voor testen vóór de implementatie en het vervolgens implementeren op een productieserver nadat het testen is voltooid. U kunt ook een voltooid en getest project implementeren op meerdere productieservers in een netwerktaakverdelingscluster of op een faseringsserver en een productieserver.

Als u een project wilt implementeren in een andere database of instantie, wijzigt u het installatiedoel in het invoerbestand met behulp van een van de methoden die in de volgende procedure worden beschreven:

Het installatiedoel wijzigen nadat de invoerbestanden zijn gegenereerd

• Voer de SQL Server Analysis Services Implementatiewizard interactief uit. Geef op de pagina Installatiedoel een nieuwe bestemming op voor het SQL Server Analysis Services-exemplaar en de database.

  – of –

• Voer de sql Server Analysis Services-implementatiewizard uit bij de opdrachtprompt en stel de wizard in om uit te voeren in de antwoordbestandsmodus.

  – of –

• Wijzig het <bestand project name.deploymenttargets >met behulp van een teksteditor.

Implementatiescriptbestanden - Opties voor partitie- en rolimplementatie

De Implementatiewizard leest de partitie- en rolimplementatieopties uit het <projectbestand naam.deploymentoptions>. Sql Server Data Tools maakt dit bestand wanneer u het project bouwt. SQL Server Data Tools gebruikt vervolgens de opties voor partitie- en rolimplementatie van het huidige project wanneer het <bestand project name.deploymentoptions >wordt gemaakt.

Opties voor partitie- en rolimplementatie controleren

De implementatieopties in het <bestand project name.deploymentoptions >bevatten het volgende:

Opties voor partitieimplementatie
Het <bestand project name.deploymentoptions >geeft aan of bestaande partities in de doeldatabase worden bewaard of overschreven (standaard). Als bestaande partities behouden blijven, worden alleen nieuwe partities geïmplementeerd en blijven de partities en aggregatieontwerpen voor alle bestaande maateenheidgroepen ongewijzigd.

Als de meergroep waarin de partitie bestaat wordt verwijderd, wordt de partitie automatisch verwijderd.

Opties voor rolimplementatie
Het <bestand project name.deploymentoptions >geeft een van de volgende opties voor rolimplementatie op:

• Bestaande rollen en rolleden in de doeldatabase blijven behouden en alleen nieuwe rollen en rolleden worden geïmplementeerd.

• Alle bestaande rollen en leden in de doeldatabase worden vervangen door de rollen en leden die worden geïmplementeerd.

• Bestaande rollen en rolleden in de doeldatabase blijven behouden en er worden geen nieuwe rollen geïmplementeerd.

Wanneer bestaande rollen en leden behouden blijven, worden de machtigingen die aan deze rollen zijn gekoppeld, opnieuw ingesteld op geen. Beveiligingsmachtigingen zijn opgenomen door de objecten die ze beveiligen, niet door de beveiligingsrollen waaraan ze zijn gekoppeld. Zie 'Rollen en leden behouden' in de Microsoft Knowledge Base voor meer informatie over het werken met dit gedrag met behulp van de wizard Analysis Service-implementatie.

Opties voor partitie- en rolimplementatie wijzigen

Mogelijk moet u het project implementeren met verschillende partitie- en rolopties dan de opties die zijn opgeslagen in het <bestand project name.deploymentoptions>. U kunt bijvoorbeeld bestaande partities, rollen en rolleden behouden in plaats van alle bestaande partities, rollen en rolleden te vervangen, zoals aangegeven in het <project name>.deploymentoptions bestand.

Als u de implementatie van partities en rollen in een project wilt wijzigen, kunt u de instellingen voor partities en rollen in het project niet wijzigen omdat deze opties niet worden weergegeven in het dialoogvenster < van het >project in SQL Server Data Tools. Als u de implementatieopties voor rollen en partities wilt wijzigen, moet u deze informatie wijzigen in het <project name.deploymentoptions-bestand >zelf. In de volgende procedure wordt beschreven hoe u de partitie- en rolimplementatieopties wijzigt in het <bestand project name.deploymentoptions>.

De implementatie van partities of rollen wijzigen nadat de invoerbestanden zijn gegenereerd

• Voer de implementatiewizard interactief uit en geef op de pagina Partitie- en rolimplementatieopties nieuwe implementatieopties op voor de partities en rollen.

  – of –

• Voer de Implementatiewizard uit op de opdrachtprompt en stel de wizard in om uit te voeren in de antwoordbestandmodus.

  – of –

• Open de <project name.deploymentoptions >in een teksteditor en wijzig de opties handmatig. De opties voor PartitionDeployment zijn DeployPartitions, RetainPartitions. De opties voor RoleDeployment zijn DeployRolesAndMembers, DeployRolesRetainMembers, RetainRoles.

Implementatiescriptbestanden - Configuratie-instellingen voor oplossingsimplementatie

De implementatiewizard leest de partitie- en rolimplementatieopties die u in het implementatiescript gebruikt vanuit het < bestand project name.configsettings>. Voor multidimensionale projecten maakt SQL Server Data Tools dit bestand wanneer u het project bouwt. Voor tabellaire projecten, afhankelijk van de versie, kan het nodig zijn om de implementatiewizard uit te voeren in de antwoordmodus om het .configsettings-bestand te genereren. SQL Server Data Tools maakt gebruik van de configuratie-instellingen van het huidige project om het <bestand project name.configsettings >te maken.

Configuratie-instellingen controleren

Hier volgen de configuratie-instellingen die zijn opgeslagen in het <bestand project name.configsettings>:

• Verbindingsreeksen voor gegevensbron : dit zijn de verbindingsreeksen voor elke gegevensbron op basis van de waarden die zijn opgegeven in het project. De gebruikers-id en het wachtwoord worden altijd verwijderd uit de verbindingsreeks voordat de rest van de tekenreeks in dit bestand wordt opgeslagen. Als de implementatiewizard echter rechtstreeks naar een Analysis Services-exemplaar wordt geïmplementeerd, kunt u de juiste gebruikers-id en wachtwoordgegevens toevoegen in de wizard om een geslaagde verwerking van de implementatiedatabase mogelijk te maken. Deze verbindingsgegevens worden niet opgeslagen in het implementatiescript zelf, zelfs niet wanneer de Deployment Wizard het opslaat.

• Imitatieaccounts : met deze instelling geeft u de gebruikersnaam op die sql Server Analysis Services gebruikt voor het uitvoeren van instructies in elke gegevensbron. Als er geen imitatieaccount is opgegeven, gebruikt SQL Server Analysis Services het aanmeldingsaccount om instructies uit te voeren. Als het aanmeldingsaccount rechtstreeks in de gegevensbron machtigingen krijgt, hebben alle databasebeheerders in alle databases in het SQL Server Analysis Services-exemplaar toegang tot de gegevensbron via het aanmeldingsaccount. Als een gebruikersaccount en wachtwoord zijn opgegeven, worden deze gegevens altijd verwijderd voordat de imitatiegegevens in dit bestand worden opgeslagen. Als de implementatiewizard echter rechtstreeks naar een Analysis Services-exemplaar wordt geïmplementeerd, kunt u de juiste gebruikers-id en wachtwoordgegevens toevoegen in de wizard om een geslaagde verwerking van de implementatiedatabase mogelijk te maken. Deze imitatie-informatie wordt niet opgeslagen in het implementatiescript zelf als deze wordt opgeslagen door de implementatiewizard.

  Opmerking

  Voor tabellaire modellen op het compatibiliteitsniveau 1400 en hoger met gestructureerde providergegevensbronverbindingen, worden wanneer Configuratie-instellingen voor bestaande objecten behouden wordt geselecteerd op de pagina Configuratie-eigenschappen opgeven van de wizard, de gebruikersnaam en het wachtwoord die zijn opgeslagen in de database van het tabellaire model van de doelserver niet bewaard. Beheerders moeten de gebruikersnaam en het wachtwoord handmatig instellen met behulp van SSMS nadat de implementatie is voltooid.

• Sleutelfoutlogboekbestanden : met deze instelling geeft u de bestandsnaam en het pad op van het sleutelfoutlogboekbestand voor elke kubus, maateenheidgroep, partitie en dimensie in de database.

• Opslaglocaties : met deze instelling geeft u de opslaglocatie op voor elke kubus, maateenheidgroep en partitie in de database. Als er geen waarde wordt opgegeven voor een object, gebruikt de wizard Implementatie de standaardlocatie voor het object. Partities gebruiken bijvoorbeeld de locatie voor de maateenheidgroep, maateenheidgroepen gebruiken de locatie voor de kubus en kubussen gebruiken de standaardlocatie voor objecten op het serverexemplaren. De opslaglocatie kan een lokaal of UNC-pad (Universal Naming Convention) zijn.

• Rapportserver : met deze instelling geeft u de locatie van de rapportserver en map op voor elke rapportactie die in elke kubus in de database is gedefinieerd.

Configuratie-instellingen wijzigen

In sommige gevallen moet u het project mogelijk implementeren met andere configuratie-instellingen dan de instellingen die zijn opgeslagen in het < bestand project name.configsettings>. U kunt bijvoorbeeld de verbindingsreeks wijzigen in een of meer gegevensbronnen of opslaglocaties opgeven voor specifieke partities of maateenheidgroepen.

Als u de implementatie van partities en rollen in een project wilt wijzigen, moet u deze informatie wijzigen in het < bestand project name.configsettings>, zoals beschreven in de onderstaande procedure. U kunt de instellingen voor partities en rollen in het project niet wijzigen omdat deze opties niet worden weergegeven in het dialoogvenster < van het >project in SQL Server Data Tools.

Configuratie-instellingen wijzigen nadat de invoerbestanden zijn gegenereerd

• Voer de wizard Implementatie interactief uit en geef op de pagina Configuratie-instellingen de configuratie-instelling op voor de objecten die worden geïmplementeerd.

  – of –

• Voer de implementatiewizard uit via de opdrachtprompt en stel de wizard in om uit te voeren in de antwoordenbestandsmodus.

  – of –

• Wijzig het <bestand project name.configsettings >met behulp van een teksteditor.

Scriptbestanden voor implementatie - Verwerkingsopties

De Implementatiewizard leest de verwerkingsopties uit het <project>.deploymentoptions-bestand. Sql Server Data Tools maakt dit bestand wanneer u het project bouwt. SQL Server Data Tools maakt gebruik van de verwerkingsopties die zijn opgegeven op de pagina Implementatie van het dialoogvenster < van >het project om het < projectnaam.deploymentoptions-bestand> te maken.

Verwerkingsopties controleren

De configuratie-instellingen die zijn opgeslagen in het <bestand project name.deploymentoptions >zijn:

• Verwerkingsmethode : met deze instelling bepaalt u of de geïmplementeerde objecten worden verwerkt na de implementatie en het type verwerking dat wordt uitgevoerd. Er zijn drie verwerkingsopties:

  • Met standaardverwerking (standaard) wordt de processtatus van databaseobjecten gedetecteerd en wordt de verwerking uitgevoerd die nodig is voor het leveren van niet-verwerkte of gedeeltelijk verwerkte objecten aan een volledig verwerkte status.

  • Volledige verwerking verwerkt een object en alle objecten die het bevat. Wanneer Proces volledig wordt uitgevoerd op een object dat al is verwerkt, worden alle gegevens in het object door Analysis Services verwijderd en vervolgens het object verwerkt.

  • Geen betekent dat er geen verwerking wordt uitgevoerd.

• Opties voor terugschrijven-tabel: als write-back is ingeschakeld in het project, definieert deze instelling hoe write-back wordt verwerkt. Er zijn drie opties voor writeback-tabellen:

  • Als er een write-backtabel bestaat, wordt deze standaard gebruikt. Als er geen write-backtabel bestaat, wordt er een nieuwe writeback-tabel gemaakt.

  • Als er al een write-backtabel bestaat, mislukt de implementatie. Als er geen write-backtabel bestaat, wordt er een nieuwe writeback-tabel gemaakt.

  • Ongeacht of er al een write-backtabel bestaat, wordt er een nieuwe writeback-tabel gemaakt. In dit geval verwijdert de Implementatiewizard een bestaande tabel en vervangt deze door een nieuwe writeback-tabel.

• Transactionele implementatie : met deze instelling bepaalt u of de implementatie van metagegevenswijzigingen en procesopdrachten plaatsvindt in één transactie of in afzonderlijke transacties.

  • Als deze optie Waar (standaard) is, implementeert SQL Server Analysis Services alle metagegevenswijzigingen en alle procesopdrachten binnen één transactie.

  • Als deze optie Onwaar is, implementeert SQL Server Analysis Services de metagegevenswijzigingen in één transactie en implementeert u elke verwerkingsopdracht in een eigen transactie.

Verwerkingsopties wijzigen

Mogelijk moet u het project echter implementeren met andere verwerkingsopties dan de opties die zijn opgeslagen in het <bestand project name.deploymentoptions>. U wilt bijvoorbeeld dat alle objecten volledig worden verwerkt of verwerkt met behulp van de standaardverwerkingsoptie, of dat er geen verwerking plaatsvindt. Als de kubussen of dimensies zijn ingeschakeld voor schrijven, kunt u opgeven of een nieuwe of bestaande writeback-tabel moet worden gebruikt.

Als u de verwerkingsopties wilt wijzigen die tijdens de implementatie worden gebruikt, kunt u het project bewerken en opnieuw opbouwen, of de verwerkingsopties in het invoerbestand wijzigen met behulp van een van de methoden zoals beschreven in de volgende procedure.

Verwerkingsopties wijzigen nadat de invoerbestanden zijn gegenereerd

• Voer de implementatiewizard interactief uit. Geef op de pagina Verwerkingsopties de verwerkingsopties op voor het project dat wordt geïmplementeerd.

  – of –

• Voer de wizard Implementatie uit bij de opdrachtprompt en stel de wizard in om uit te voeren in de antwoordbestandsmodus.

  – of –

• Wijzig het <bestand project name.deploymentoptions >met behulp van een teksteditor.

Zie ook

Modeloplossingen implementeren met XMLA
Modeloplossingen implementeren met het implementatiehulpprogramma