Distribuire soluzioni di modelli tramite la Distribuzione guidata

Articolo
05/08/2023

Si applica a: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

La distribuzione guidata SQL Server Analysis Services usa i file di output JSON generati da un progetto di SQL Server Analysis Services come file di input. Questi file di input sono facilmente modificabili per personalizzare la distribuzione di un progetto di SQL Server Analysis Services. Lo script di distribuzione generato può quindi essere eseguito subito oppure salvato per essere distribuito in una fase successiva.

La procedura guidata/utilità di distribuzione viene installata con SQL Server Management Studio (SSMS). Assicurarsi di usare la versione più recente. Se viene eseguito dal prompt dei comandi, per impostazione predefinita, la versione più recente della distribuzione guidata viene installata in C:\Programmi (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.

È possibile distribuire usando la procedura guidata, come descritto qui. È anche possibile automatizzare la distribuzione o utilizzare la funzionalità di sincronizzazione. Se il database distribuito è di grandi dimensioni, è consigliabile utilizzare partizioni sui sistemi di destinazione. È possibile automatizzare la creazione e la popolazione delle partizioni usando tabulare Object Model (TOM), Tabular Model Scriting Language (TMSL) e Analysis Management Objects (AMO).

Importante

Né i file di output né lo script di distribuzione conterrà l'ID utente o la password se vengono specificati nella stringa di connessione per un'origine dati o per scopi di rappresentazione. Poiché in questo scenario sono necessarie per l'elaborazione, è necessario aggiungere tali informazioni manualmente. Se la distribuzione non include l'elaborazione, è possibile aggiungere le informazioni di connessione e le impostazioni di rappresentazione in base alle esigenze dopo la distribuzione. Se la distribuzione include l'elaborazione, si possono aggiungere tali informazioni e impostazioni nella procedura guidata oppure nello script di distribuzione dopo il relativo salvataggio.

Eseguire la distribuzione guidata

La distribuzione guidata può essere eseguita come segue:

Interattivo : quando viene eseguito in modo interattivo, la Distribuzione guidata genera uno script di distribuzione basato sui file di input, come modificato in modo interattivo dall'input dell'utente. Tramite la procedura guidata eventuali modifiche apportate dall'utente vengono applicate solo allo script di distribuzione. I file di input non vengono modificati.
Dal prompt dei comandi : quando viene eseguito al prompt dei comandi, la Distribuzione guidata genera uno script di distribuzione in base alle opzioni usate per eseguire la procedura guidata. Tramite la procedura guidata potrebbe venire richiesto l'input dell'utente e potrebbero venire modificati i file di input in base a tale input, potrebbe venire eseguita una distribuzione automatica invisibile all'utente oppure potrebbe venire creato uno script di distribuzione da utilizzare successivamente.

Eseguire in modo interattivo

Quando si esegue in modo interattivo, la Distribuzione guidata legge i valori dai file di input e presenta queste informazioni all'utente. È possibile modificare questi valori di input, ad esempio destinazione di distribuzione, impostazioni di configurazione, opzioni di distribuzione e stringa di connessione password o lasciarle come è. Se si modificano valori di input, la procedura guidata usa queste modifiche durante la generazione dello script di distribuzione. Tramite la procedura guidata non vengono tuttavia apportate modifiche al file di input.

Nota

Se si vuole modificare i valori di input della Distribuzione guidata, eseguire la procedura guidata al prompt dei comandi e impostare la procedura guidata per l'esecuzione in modalità file di risposta.

Dopo aver esaminato i valori di input e apportare modifiche desiderate, la procedura guidata genera lo script di distribuzione. È possibile eseguire questo script di distribuzione immediatamente nel server di destinazione o salvarlo per utilizzarlo successivamente.

Per eseguire la Distribuzione guidata Analysis Services in modo interattivo

Fare clic su Start, quindi digitare Distribuzione guidata Analysis Services.

-oppure-
Nella cartella Progetti del progetto SQL Server Analysis Services fare doppio clic sul <file nome> progetto.asdatabase.

Nota

Se non è possibile trovare il file .asdatabase, provare a utilizzare la funzionalità di ricerca e specificare *.asdatabase. In alternativa, potrebbe essere necessario compilare il progetto in SSDT.

Eseguire al prompt dei comandi

La distribuzione guidata può essere eseguita anche al prompt dei comandi. Quando viene eseguito al prompt dei comandi, specificare il percorso completo del file .asdatabase ed eseguire la procedura guidata in una delle modalità seguenti:

Modalità file di risposte
In modalità file di risposta, la procedura guidata consente di modificare in modo interattivo i file di input generati originariamente quando il progetto di SQL Server Analysis Services è stato compilato in SQL Server Data Tools. La procedura guidata salva questi file di input modificati prima di generare lo script di distribuzione. I file di input modificati diventano il nuovo punto di partenza per la successiva esecuzione della procedura guidata.

Per eseguire la procedura guidata in modalità file di risposta, usare l'opzione /a .

Modalità automatica
In modalità non interattiva viene eseguita una distribuzione automatica invisibile all'utente basata sulle informazioni incluse nei file di input.

Per eseguire la procedura guidata in modalità invisibile all'utente, usare l'opzione /s . Quando si esegue la procedura guidata in modalità non interattiva, i messaggi vengono inviati alla console o a un file di log, se presente.

Modalità output
In modalità di output la procedura guidata genera uno script di distribuzione per un'esecuzione successiva in base ai file di input.

Per eseguire la procedura guidata in modalità di output, usare l'opzione /o e specificare un nome file di output.

Per altre informazioni su queste opzioni della riga di comando, vedere Distribuire soluzioni modello con l'utilità di distribuzione.

Per eseguire la Distribuzione guidata Analysis Services al prompt dei comandi

Se installato con SSMS 18.x, aprire un prompt dei comandi e passare al percorso predefinito C:\Programmi (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE.
Digitare Microsoft.AnalysisServices.Deployment.exe seguito dalle opzioni corrispondenti alla modalità in cui si desidera eseguire la procedura guidata.

Informazioni sullo script di distribuzione

Lo script di distribuzione XMLA generato dalla Distribuzione guidata è costituito da due sezioni:

La prima parte dello script di distribuzione contiene i comandi necessari per creare, modificare o eliminare gli oggetti Microsoft SQL Server appropriati nel database di destinazione. Per impostazione predefinita, i file di input generati dal progetto di SQL Server Analysis Services si basano su una distribuzione incrementale. Lo script di distribuzione di XMLA avrà pertanto effetto solo sugli oggetti modificati o eliminati.
La seconda parte dello script di distribuzione contiene i comandi necessari per elaborare soltanto gli oggetti creati o modificati nel server di destinazione (opzione Elaborazione predefinita) o per elaborare completamente il database di destinazione. Si può inoltre scegliere di non includere alcun comando di elaborazione nello script di distribuzione.

L'intero script di distribuzione può essere eseguito in una singola transazione o in più transazioni. Se lo script viene eseguito in più transazioni, la prima parte dello script viene eseguita come singola transazione e ogni oggetto viene elaborato nella relativa transazione.

Importante

La distribuzione guidata SQL Server Analysis Services distribuisce solo oggetti in un singolo database SQL Server Analysis Services. Non è possibile distribuire alcun oggetto o dato a livello del server.

File di script di distribuzione - Input usato per creare script di distribuzione

Quando si compila un progetto, SQL Server Data Tools genera file per il progetto. SQL Server Data Tools quindi inserisce questi file nella cartella Output del progetto. Per impostazione predefinita, l'output viene inserito nella cartella \Bin. Nella tabella seguente sono elencati i file XML creati SQL Server Data Tools:

File	Descrizione
<nome> progetto. asdatabase	Un file XMLA per progetti modello tabulari multidimensionali o 1100/1103 o un file JSON per progetti di modello tabulari 1200 e versioni successive. Contiene le definizioni dichiarative per tutti gli oggetti SQL Server Analysis Services nel progetto.
<nome> progetto. deploymenttargets	Contiene il nome dell'istanza di SQL Server Analysis Services e del database in cui verranno creati gli oggetti SQL Server Analysis Services.
<nome> progetto. configsettings	Contiene le impostazioni specifiche all'ambiente, quali le informazioni sulla connessione all'origine dati e i percorsi di archiviazione degli oggetti. Impostazioni in questo file eseguire l'override delle impostazioni nel < file nome> progetto.asdatabase.
<nome> progetto. deploymentoptions	Contiene le opzioni di distribuzione, come ad esempio se la distribuzione è transazionale o se gli oggetti distribuiti vanno elaborati dopo la distribuzione.

SQL Server Data Tools non archivia mai le password nei file di progetto.

Modifica dei file di input

La modifica dei valori nei file di input o dei valori recuperati dai file di input consente di modificare la destinazione di distribuzione, le impostazioni di configurazione e le opzioni di distribuzione senza modificare l'intero < file nome> progetto.asdatabase (o un file di script intero se si genera uno script da un database SQL Server Analysis Services esistente). La possibilità di modificare singoli file facilita la creazione di script di distribuzione diversi per vari scopi.

File di script di distribuzione - Specifica della destinazione di installazione

La Distribuzione guidata legge le informazioni di destinazione dell'installazione dal < file project name.deploymenttargets>. SQL Server Data Tools crea questo file quando si compila il progetto. SQL Server Data Tools usa il database e il server specificati nella pagina Distribuzione della finestra di <dialogo Proprietà pagine nome>progetto per creare il < file nome> progetto.targets.

Modifica della destinazione di installazione

In alcune situazioni, potrebbe essere necessario distribuire un progetto in un database o in un'istanza diversa da quella specificata nella pagina Distribuzione . Potrebbe essere utile ad esempio distribuire il progetto su un server di prova prima della distribuzione e successivamente distribuire il progetto su un server di produzione dopo il completamento delle prove. Quando il progetto è completato e testato, potrebbe essere opportuno distribuirlo su più server di produzione in un cluster con bilanciamento del carico di rete o su un server dell'area di gestione temporanea e un server di produzione.

Per distribuire un progetto in un database o un'istanza diversa, modificare la destinazione di installazione nel file di input usando uno dei metodi descritti nella procedura seguente:

Per modificare la destinazione di installazione dopo la generazione dei file di input.

Eseguire l'SQL Server Analysis Services Distribuzione guidata in modo interattivo. Nella pagina Destinazione installazione specificare una nuova destinazione per l'istanza di SQL Server Analysis Services e il database.

-oppure-
Eseguire l'SQL Server Analysis Services Distribuzione guidata al prompt dei comandi e impostare la procedura guidata per l'esecuzione in modalità file di risposta.

-oppure-
Modificare il < file name.deploymenttargets> usando qualsiasi editor di testo.

File di script di distribuzione - Opzioni di distribuzione dei ruoli e delle partizioni

La Distribuzione guidata legge le opzioni di distribuzione delle partizioni e dei < ruoli dal file project name.deploymentoptions>. SQL Server Data Tools crea questo file quando si compila il progetto. SQL Server Data Tools quindi usa le opzioni di distribuzione di partizione e ruolo del progetto corrente quando viene creato il < file nome> progetto.deploymentoptions.

Revisione delle opzioni di distribuzione delle partizioni e dei ruoli

Le opzioni di distribuzione nel < file project name.deploymentoptions >includono quanto segue:

Opzioni di distribuzione delle partizioni
Il < file project name.deploymentoptions> specifica se le partizioni esistenti nel database di destinazione vengono mantenute o sovrascritte (impostazione predefinita). Se le partizioni esistenti vengono mantenute, verranno distribuite solo le nuove partizioni, e le partizioni e le progettazioni delle aggregazioni in tutti i gruppi di misure esistenti non saranno modificate.

Se il gruppo di misure contenente la partizione viene eliminato, la partizione viene eliminata automaticamente.

Opzioni di distribuzione dei ruoli
Il < file project name.deploymentoptions> specifica una delle opzioni di distribuzione dei ruoli seguenti:

I ruoli e i membri di ruolo esistenti contenuti nel database di destinazione vengono mantenuti e vengono distribuiti solo i nuovi ruoli e membri di ruolo.
Tutti i membri e ruoli esistenti contenuti nel database di destinazione vengono sostituiti dai ruoli e dai membri distribuiti.
I ruoli e i membri di ruolo esistenti contenuti nel database di destinazione vengono mantenuti e non viene distribuito nessun nuovo ruolo.

Quando vengono mantenuti ruoli e membri esistenti, le autorizzazioni associate a tali ruoli vengono reimpostate in nessuna. Le autorizzazioni di sicurezza sono contenute negli oggetti da esse protetti, non nei ruoli di sicurezza a cui sono associate. Per altre informazioni su come usare questo comportamento usando la Distribuzione guidata di Analysis Service, vedere "Conservare ruoli e membri" nella Microsoft Knowledge Base.

Modifica delle opzioni di distribuzione delle partizioni e dei ruoli

Potrebbe essere necessario distribuire il progetto usando diverse opzioni di partizione e ruolo rispetto a quelle archiviate nel < file project name.deploymentoptions>. Ad esempio, è possibile mantenere le partizioni, i ruoli e i membri del ruolo esistenti, anziché sostituire tutte le partizioni, i ruoli e i membri esistenti, come indicato nel < file project name.deploymentoptions>.

Per modificare la distribuzione di partizioni e ruoli in un progetto, non è possibile modificare le impostazioni di partizione e ruoli all'interno del progetto perché la <finestra di dialogo Proprietà pagine del progetto> in SQL Server Data Tools non visualizza queste opzioni. Se si desidera modificare le opzioni di distribuzione per ruoli e partizioni, è necessario modificare queste informazioni all'interno del < file project name.deploymentoptions >stesso. La procedura seguente descrive come modificare le opzioni di distribuzione della partizione e del ruolo all'interno del < file project name.deploymentoptions>.

Per modificare la distribuzione delle partizioni o dei ruoli dopo la generazione dei file di input

Eseguire la distribuzione guidata in modo interattivo e nella pagina Opzioni di distribuzione partiziona e ruolo specificare nuove opzioni di distribuzione per le partizioni e i ruoli.

-oppure-
Eseguire la Distribuzione guidata al prompt dei comandi e impostare la procedura guidata da eseguire in modalità file di risposta.

-oppure-
Aprire il <nome> del progetto.deploymentoptions in qualsiasi editor di testo e modificare manualmente le opzioni. Le opzioni per PartitionDeployment sono DeployPartitions, RetainPartitions. Le opzioni per RoleDeployment sono DeployRolesAndMembers, DeployRolesRetainMembers, RetainRoles.

File di script di distribuzione - Impostazioni di configurazione della distribuzione della soluzione

La Distribuzione guidata legge le opzioni di distribuzione di partizione e ruolo usate nello script di distribuzione dal < file project name.configsettings>. Per i progetti multidimensionali, SQL Server Data Tools crea questo file quando si compila il progetto. Per i progetti tabulari, a seconda della versione, potrebbe essere necessario eseguire la distribuzione guidata in modalità risposta per generare il file con estensione configsettings. SQL Server Data Tools usa le impostazioni di configurazione del progetto corrente per creare il < file project name.configsettings>.

Revisione delle impostazioni di configurazione

Di seguito sono riportate le impostazioni di configurazione archiviate nel < file project name.configsettings>:

Stringhe di connessione origine dati: queste sono le stringhe di connessione per ogni origine dati in base ai valori specificati nel progetto. L'ID utente e la password vengono sempre rimossi dalla stringa di connessione prima che il resto della stringa venga archiviato nel file. Se invece viene eseguita la distribuzione direttamente in un'istanza di Analysis Services, è possibile aggiungere le informazioni appropriate relative a ID utente e password all'interno della Distribuzione guidata per garantire l'elaborazione corretta del database di distribuzione. Queste informazioni di connessione non vengono archiviate nello script di distribuzione eventualmente salvato dalla Distribuzione guidata.
Account di rappresentazione: questa impostazione specifica il nome utente usato SQL Server Analysis Services per eseguire istruzioni in ogni origine dati. Se non viene specificato alcun account di rappresentazione, SQL Server Analysis Services usa l'account di accesso per eseguire istruzioni. Se l'account di accesso viene concesso direttamente nell'origine dati, tutti gli amministratori di database in tutti i database dell'istanza di SQL Server Analysis Services hanno accesso all'origine dati tramite l'account di accesso. Se vengono specificati un account utente e una password, tali informazioni vengono sempre rimosse prima che le impostazioni di rappresentazione vengano archiviate nel file. Se invece viene eseguita la distribuzione direttamente in un'istanza di Analysis Services, è possibile aggiungere le informazioni appropriate relative a ID utente e password all'interno della Distribuzione guidata per garantire l'elaborazione corretta del database di distribuzione. Queste impostazioni di rappresentazione non vengono archiviate nello script di distribuzione eventualmente salvato dalla Distribuzione guidata.

Nota

Per i modelli tabulari a livello di compatibilità 1400 e superiore con connessioni di origine dati del provider strutturato, quando si seleziona Conserva le impostazioni di configurazione per gli oggetti esistenti nella pagina Specifica proprietà di configurazione della procedura guidata, il nome utente e la password archiviati nel database del modello tabulare del server di destinazione non vengono mantenuti. Gli amministratori devono impostare manualmente il nome utente e la password usando SSMS dopo il completamento della distribuzione.
File di log degli errori chiave: questa impostazione specifica il nome e il percorso del file di log degli errori chiave per ogni cubo, gruppo di misure, partizione e dimensione nel database.
Percorsi di archiviazione : questa impostazione specifica il percorso di archiviazione per ogni cubo, gruppo di misure e partizione nel database. Se non viene fornito alcun valore per un oggetto, la Distribuzione guidata usa la posizione predefinita per l'oggetto. Ad esempio, le partizioni usano il percorso per il gruppo di misure, i gruppi di misure usano il percorso per il cubo e i cubi usano la posizione predefinita per gli oggetti nell'istanza del server. La posizione di archiviazione può essere un percorso locale o un percorso UNC (Universal Naming Convention).
Server di report: questa impostazione specifica il server di report e il percorso della cartella per ogni azione del report definita in ogni cubo del database.

Modifica delle impostazioni di configurazione

In alcuni casi, potrebbe essere necessario distribuire il progetto usando impostazioni di configurazione diverse rispetto a quelle archiviate nel < file project name.configsettings>. Potrebbe ad esempio essere preferibile modificare la stringa di connessione per una o più origini dati o specificare posizioni di archiviazione per particolari partizioni o gruppi di misure.

Per modificare la distribuzione di partizioni e ruoli in un progetto, è necessario modificare queste informazioni all'interno del < file project name.configsettings>, come descritto nella procedura seguente. Non è possibile modificare le impostazioni delle partizioni e dei ruoli all'interno del progetto perché la <finestra di dialogo Proprietà pagine del>progetto in SQL Server Data Tools non visualizza queste opzioni.

Nota

Le impostazioni di configurazione possono essere applicate a tutti gli oggetti o solo ai nuovi oggetti creati. Applicare le impostazioni di configurazione agli oggetti appena creati solo quando si distribuiscono oggetti aggiuntivi in un database SQL Server Analysis Services distribuito in precedenza e non si vuole sovrascrivere gli oggetti esistenti. Per specificare se le impostazioni di configurazione si applicano a tutti gli oggetti o solo a quelle appena create, impostare questa opzione nel < file project name.deploymentoptions>.

Per modificare le opzioni di configurazione dopo la generazione dei file di input

Eseguire la distribuzione guidata in modo interattivo e nella pagina Impostazioni di configurazione specificare l'impostazione di configurazione per gli oggetti distribuiti.

-oppure-
Eseguire la Distribuzione guidata al prompt dei comandi e impostare la procedura guidata da eseguire in modalità file di risposta.

-oppure-
Modificare il < file nome> progetto.configsettings usando qualsiasi editor di testo.

File di script di distribuzione - Opzioni di elaborazione

La Distribuzione guidata legge le opzioni di elaborazione dal < file project name.deploymentoptions>. SQL Server Data Tools crea questo file quando si compila il progetto. SQL Server Data Tools usa le opzioni di elaborazione specificate nella pagina Distribuzione della finestra di <dialogo Proprietà nome progetto> per creare il < file nome> progetto.deploymentoptions.

Revisione delle opzioni di elaborazione

Le impostazioni di configurazione archiviate all'interno del < file project name.deploymentoptions >sono:

Metodo di elaborazione : questa impostazione controlla se gli oggetti distribuiti vengono elaborati dopo la distribuzione e il tipo di elaborazione che verrà eseguito. Sono previste tre opzioni di elaborazione:
- L'elaborazione predefinita (impostazione predefinita) rileva lo stato del processo degli oggetti di database ed esegue l'elaborazione necessaria per distribuire oggetti non elaborati o parzialmente elaborati in uno stato completamente elaborato.
- L'elaborazione completa elabora un oggetto e tutti gli oggetti contenuti. Quando viene eseguita l'elaborazione completa su un oggetto che è già stato elaborato, questa operazione viene completata solo dopo che sono stati eliminati tutti i dati contenuti nell'oggetto.
- Nessuno significa che non viene eseguita alcuna elaborazione.
Opzioni di tabella writeback : se il writeback è abilitato nel progetto, questa impostazione definisce la modalità di gestione del writeback. Sono previste tre opzioni per la tabella writeback:
- Per impostazione predefinita, se esiste una tabella writeback essa verrà utilizzata. Se non esiste alcuna tabella writeback, ne verrà creata una nuova.
- Se la tabella writeback esiste già, non potrà essere portata a termine la distribuzione. Se non esiste alcuna tabella writeback, ne verrà creata una nuova.
- Anche se dovesse esistere già una tabella writeback, ne verrà creata una nuova. In questo caso, la Distribuzione guidata eliminerà qualsiasi tabella esistente e la sostituirà con una nuova tabella writeback.
Distribuzione transazionale : questa impostazione controlla se la distribuzione dei metadati cambia e elabora i comandi di elaborazione si verifica in una singola transazione o in transazioni separate.
- Se questa opzione è True (impostazione predefinita), SQL Server Analysis Services distribuisce tutte le modifiche ai metadati e tutti i comandi di processo all'interno di una singola transazione.
- Se questa opzione è False, SQL Server Analysis Services distribuisce le modifiche dei metadati in una singola transazione e distribuisce ogni comando di elaborazione nella propria transazione.

Modifica delle opzioni di elaborazione

Tuttavia, potrebbe essere necessario distribuire il progetto usando opzioni di elaborazione diverse da quelle archiviate nel < file nome> progetto.deploymentoptions. Potrebbe ad esempio essere preferibile elaborare tutti gli oggetti in modo completo o elaborarli utilizzando l'opzione di elaborazione predefinita o infine non elaborarli affatto. Se i cubi o le dimensioni sono abilitati per la scrittura, è possibile specificare se verrà utilizzata una tabella writeback nuova o preesistente.

Per modificare le opzioni di elaborazione da utilizzare durante la distribuzione, è possibile modificare o ricompilare il progetto, oppure è possibile modificare le opzioni di elaborazione nel file di input utilizzando uno dei metodi descritti nella procedura seguente.

Per modificare le opzioni di elaborazione dopo la generazione dei file di input

Eseguire la Distribuzione guidata in modo interattivo. Nella pagina Opzioni di elaborazione specificare le opzioni di elaborazione per il progetto da distribuire.

-oppure-
Eseguire la Distribuzione guidata al prompt dei comandi e impostare la procedura guidata per l'esecuzione in modalità file di risposte.

-oppure-
Modificare il < file project name.deploymentoptions >usando qualsiasi editor di testo.

Vedi anche

Distribuire soluzioni di modelli usando XMLA
Distribuire soluzioni di modello con l'utilità di distribuzione