Voorbeeld: Scripts voor migratieplannen
Opmerking: Dit onderwerp bevat een voorbeeldscript dat u kunt gebruiken als basis voor het scripten van een migratie met meerdere plannen die aan uw behoeften en omgeving voldoet. Dit script is uitsluitend bedoeld om als voorbeeld te worden gebruikt en niet om te worden uitgevoerd zoals het is. Zie De Content Migration Tool van Tableau-consolerunner gebruiken voor gedetailleerde instructies over het gebruik van de consolerunner.
Het Content Migration Tool van Tableau command-lijn hulpprogramma voor het uitvoeren van migraties kan worden gebruikt om de uitvoering van een migratieplan te automatiseren vanuit een externe planner (zoals Windows Task Scheduler) of vanuit een aangepast script. De consolerunner voert slechts één migratieplan (opgeslagen in een .edt-bestand) tegelijk uit. Als u een groep migratieplannen hebt die u als groep wilt uitvoeren, kunt u een aangepast script gebruiken in combinatie met de Content Migration Tool-consolerunner.
Het onderstaande voorbeeld is geschreven in PowerShell en gebruikt de consolerunner om een lijst met migratieplannen als een groep uit te voeren.
De volgende voorbeeldcode toont:
- Meerdere migratieplannen als groep uitvoeren met behulp van de consolerunner.
- Optioneel kan de implementatie van de groep met plannen onmiddellijk worden stopgezet wanneer een afzonderlijke migratie in de groep mislukt.
- Gebruik de afsluitcode van de consolerunner om te bepalen of de migratie is mislukt of dat er waarschuwingen zijn geregistreerd.
# List of migration plans to execute as a group. $planFiles = @( 'customer 1.tcmx', 'customer 2.tcmx' ) # True of false whether to continue with the next plan if a migration fails. $continueOnFailure = $false # Path to the CMT console runner executable $runnerExe = 'C:\Program Files (x86)\Tableau\Tableau Content Migration Tool\tabcmt-runner.exe' # Store the exit code from the previously run migration plan. $lastResult = -1 # Loop through and run each migration plan one at a time. $planFiles | % { $file = $_ if ($lastResult -ge 2 -and -not($continueOnFailure)) { Write-Warning "Skipping plan because previous migration failed. `nSkipped plan: $file" return } Write-Verbose "Running migration plan: $file" & $runnerExe $file $lastResult = $LASTEXITCODE if ($lastResult -ge 2) { Write-Error "Migration failed. See output or log file for error details.`nPlan: $file" -ErrorAction 'Continue' } elseif ($lastResult -eq 1) { Write-Warning "Migration completed with warnings. See output or log file for warning details.`nPlan: $file" } }
Wie kan dit doen
Om migratieplannen te scripten, moet u over het volgende beschikken:
- Beheerdersmachtigingen op de Content Migration Tool-machine.
- Een gebruikersaccount voor de Tableau-site met een Explorer-rol of hoger.
- Machtigingen voor Werkmap bekijken en downloaden/een kopie opslaan op de bronsite.
- Publicatierechten voor de bestemmingssite.