Beispiel: Skripterstellung für Migrationspläne

Hinweis: Dieses Thema enthält ein Beispielskript, das Sie als Grundlage für die Skripterstellung für eine Migration mit mehreren Planungen entsprechend Ihren Anforderungen und Ihrer Umgebung verwenden können. Dieses Skript ist nur als Beispiel gedacht und ist nicht so wie es ist auszuführen. Für detaillierte Anweisungen zur Verwendung von Console Runner, siehe Verwenden des Content Migration Tool von Tableau Konsolenläufers.

Das Content Migration Tool von Tableau-Befehlszeilendienstprogramm zum Ausführen von Migrationen kann verwendet werden, um die Ausführung eines Migrationsplans von einem externen Planer (z. B. Windows-Taskplaner) oder von einem benutzerdefinierten Skript zu automatisieren. Der Console Runner führt jeweils nur einen Migrationsplan (in einer .edt-Datei gespeichert) aus. Wenn Sie über eine Gruppe von Migrationsplänen verfügen, die Sie als Gruppe ausführen möchten, können Sie ein benutzerdefiniertes Skript in Kombination mit dem Content Migration ToolConsole Runner verwenden.

Das folgende Beispiel ist in PowerShell geschrieben und verwendet den Console Runner, um eine Liste von Migrationsplänen als Gruppe auszuführen.

Der folgende Beispielcode veranschaulicht:

  • Ausführen mehrerer Migrationspläne als Gruppe mithilfe des Console Runner.
  • Optional wird die Bereitstellung der Gruppe von Plänen sofort angehalten, wenn eine einzelne Migration in der Gruppe fehlschlägt.
  • Verwenden des Exitcodes des Console Runner, um zu ermitteln, ob die Migration fehlgeschlagen ist oder Warnungen protokolliert wurden.

 

# 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"
	}
}

Wer kann dies tun?

Sie müssen alle folgenden Voraussetzungen erfüllen, um skriptbasierte Migrationspläne zu erstellen:

  • Administratorberechtigungen auf dem Content Migration Tool-Computer.
  • Tableau Site-Benutzerkonto mit einer Explorer-Rolle oder höher.
  • Berechtigungen "Arbeitsmappe anzeigen" und "Arbeitsmappe herunterladen"/"Kopie speichern" auf der Quellsite.
  • Veröffentlichungsrechte für die Zielsite.
Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.