- Risorsa: MigrationWorkflow
- MigrationTask
- AssessmentTaskDetails
- TranslationTaskDetails
- TeradataOptions
- BteqOptions
- DatasetReference
- TranslationFileMapping
- FileEncoding
- IdentifierSettings
- IdentifierCase
- IdentifierRewriteMode
- TokenType
- Filtro
- TranslationConfigDetails
- Dialetto
- BigQueryDialect
- HiveQLDialect
- RedshiftDialect
- TeradataDialect
- Modalità
- OracleDialect
- SparkSQLDialect
- SnowflakeDialect
- NetezzaDialect
- AzureSynapseDialect
- VerticaDialect
- SQLServerDialect
- PostgresqlDialect
- PrestoDialect
- MySQLDialect
- SourceEnv
- SourceTargetLocationMapping
- SourceLocation
- TargetLocation
- TranslationDetails
- SourceTargetMapping
- SourceSpec
- Letterale
- TargetSpec
- Stato
- MigrationTaskOrchestrationResult
- AssessmentOrchestrationResultDetails
- TranslationTaskResult
- GcsReportLogMessage
- Stato
- Metodi
Risorsa: MigrationWorkflow
Un flusso di lavoro per la migrazione che specifica le operazioni da eseguire per una migrazione EDW.
Rappresentazione JSON |
---|
{ "name": string, "displayName": string, "tasks": { string: { object ( |
Campi | |
---|---|
name |
Solo output. Immutabile. Identificatore. L'identificatore univoco del flusso di lavoro di migrazione. L'ID è generato dal server. Esempio: |
displayName |
Il nome visualizzato del flusso di lavoro. Puoi impostare questa opzione per assegnare a un flusso di lavoro un nome descrittivo. Non vi è alcuna garanzia o applicazione dell'unicità. |
tasks |
Le attività in un flusso di lavoro in una mappa denominata. Il nome (chiave) non ha alcun significato ed è solo un modo conveniente per affrontare un'attività specifica in un flusso di lavoro. |
state |
Solo output. Questo stato del flusso di lavoro. |
createTime |
Ora in cui è stato creato il flusso di lavoro. |
lastUpdateTime |
Ora dell'ultimo aggiornamento del flusso di lavoro. |
MigrationTask
Una singola attività per una migrazione contenente dettagli sulla configurazione dell'attività.
Rappresentazione JSON |
---|
{ "id": string, "type": string, "details": { "@type": string, field1: ..., ... }, "state": enum ( |
Campi | |
---|---|
id |
Solo output. Immutabile. L'identificatore univoco dell'attività di migrazione. L'ID è generato dal server. |
type |
Il tipo di attività. Deve essere uno dei tipi di attività supportati: Translation_Teradata2BQ, Translation_Redshift2BQ, Translation_Bteq2BQ, Translation_Oracle2BQ, Translation_HiveQL2BQ, Translation_SparkSQL2BQ, Translation_Snowflake2BQ, Translation_Netezza2BQ, Translation_AzureSynapse2BQ, Translation_AzureSynapse2BQ, Translation_VerticaQgQreSSQL2BQ Translation, |
details |
OBSOLETO Utilizza uno dei valori task_details riportati di seguito. I dettagli dell'attività. L'URL del tipo deve essere uno dei messaggi di dettagli dell'attività supportati e corrispondere al tipo di Attività. |
state |
Solo output. Lo stato attuale dell'attività. |
processingError |
Solo output. Una spiegazione che può essere compilata quando l'attività si trova nello stato NON RIUSCITA. |
createTime |
L'ora in cui è stata creata l'attività. |
lastUpdateTime |
Data e ora dell'ultimo aggiornamento dell'attività. |
orchestrationResult |
Solo output. Informazioni aggiuntive sull'orchestrazione. |
resourceErrorDetails[] |
Solo output. Fornisce dettagli su errori e problemi riscontrati durante l'elaborazione dell'attività. La presenza di dettagli dell'errore non significa che l'attività non è riuscita. |
resourceErrorCount |
Il numero di risorse con errori. Nota: questo non è il numero totale di errori, in quanto ogni risorsa può avere più di un errore. Questo valore viene utilizzato per indicare il troncamento in quanto un valore |
metrics[] |
Le metriche per l'attività. |
Campo unione task_details . I dettagli dell'attività. task_details può essere solo uno dei seguenti: |
|
assessmentTaskDetails |
Configurazione dell'attività per la valutazione. |
translationTaskDetails |
Configurazione delle attività per la traduzione SQL batch. |
translationConfigDetails |
Configurazione delle attività per la traduzione SQL batch/offline CW. |
translationDetails |
Dettagli dell'attività per la traduzione SQL unificata. |
AssessmentTaskDetails
Configurazione dell'attività di valutazione.
Rappresentazione JSON |
---|
{ "inputPath": string, "outputDataset": string, "querylogsPath": string, "dataSource": string } |
Campi | |
---|---|
inputPath |
Obbligatorio. Percorso Cloud Storage per i file di input di valutazione. |
outputDataset |
Obbligatorio. Il set di dati BigQuery per l'output. |
querylogsPath |
Facoltativo. Un percorso Cloud Storage facoltativo per scrivere i log delle query (che viene poi utilizzato come percorso di input nell'attività di traduzione) |
dataSource |
Obbligatorio. L'origine dati o il tipo di data warehouse (ad es. TERADATA/REDSHIFT) da cui vengono estratti i dati di input. |
TranslationTaskDetails
La configurazione dell'attività di traduzione per acquisire le impostazioni necessarie per un'attività di traduzione e un'attività secondaria.
Rappresentazione JSON |
---|
{ "inputPath": string, "outputPath": string, "filePaths": [ { object ( |
Campi | |
---|---|
inputPath |
Percorso Cloud Storage per i file di input della traduzione. |
outputPath |
Percorso Cloud Storage per i file di output della traduzione. |
filePaths[] |
File Cloud Storage da elaborare per la traduzione. |
schemaPath |
Percorso di Cloud Storage ai file DDL sotto forma di schema di tabella a supporto della traduzione semantica. |
fileEncoding |
Il tipo di codifica del file. |
identifierSettings |
Le impostazioni per gli identificatori SQL. |
specialTokenMap |
La mappa che acquisisce token speciali da sostituire durante la traslazione. La chiave è un token speciale nella stringa. Il valore è il tipo di dati del token. Viene utilizzato per tradurre il modello di query SQL che contiene un token speciale come segnaposto. Il token speciale rende non valida una query da analizzare. Questa mappa verrà applicata per annotare questi token speciali con tipi per consentire all'analizzatore sintattico di capire come analizzarli in una struttura corretta con informazioni sul tipo. |
filter |
Il filtro applicato ai dettagli della traduzione. |
translationExceptionTable |
Specifica il nome esatto della tabella BigQuery ("dataset.table") da utilizzare per individuare errori di traduzione non elaborati. Se la tabella non esiste, la creeremo. Se esiste già e lo schema è lo stesso, lo riutilizzeremo. Se la tabella esiste e lo schema è diverso, verrà restituito un errore. |
Campo unione language_options . Le impostazioni specifiche della lingua per l'attività di traduzione. language_options può essere solo uno dei seguenti: |
|
teradataOptions |
Le impostazioni specifiche di SQL Teradata per l'attività di traduzione. |
bteqOptions |
Le impostazioni specifiche di BTEQ per l'attività di traduzione. |
TeradataOptions
Questo tipo non contiene campi.
Impostazioni correlate alle attività di traduzione specifiche per SQL Teradata.
BteqOptions
Impostazioni relative all'attività di traduzione BTEQ.
Rappresentazione JSON |
---|
{
"projectDataset": {
object ( |
Campi | |
---|---|
projectDataset |
Specifica il progetto e il set di dati in BigQuery che verranno utilizzati per la creazione di tabelle esterne durante la traduzione. |
defaultPathUri |
La località di Cloud Storage da utilizzare come percorso predefinito per i file che non sono altrimenti specificati nella mappa di sostituzione file. |
fileReplacementMap |
Mappa i percorsi locali utilizzati negli script BTEQ (le chiavi) ai percorsi in Cloud Storage da utilizzare al loro posto nella traduzione (il valore). |
DatasetReference
Riferimento a un set di dati BigQuery.
Rappresentazione JSON |
---|
{ "datasetId": string, "projectId": string, "datasetIdAlternative": [ string ], "projectIdAlternative": [ string ] } |
Campi | |
---|---|
datasetId |
Un ID univoco per questo set di dati, senza il nome del progetto. L'ID deve contenere solo lettere (a-z, A-Z), numeri (0-9) o trattini bassi (_). La lunghezza massima è di 1024 caratteri. |
TranslationFileMapping
Mappatura tra un file di input e un file di output da tradurre in un'attività secondaria.
Rappresentazione JSON |
---|
{ "inputPath": string, "outputPath": string } |
Campi | |
---|---|
inputPath |
Percorso Cloud Storage di un file da tradurre in un'attività secondaria. |
outputPath |
Il percorso Cloud Storage in cui riscrivere il file di input corrispondente. |
FileEncoding
I tipi di codifica dei file.
Enum | |
---|---|
FILE_ENCODING_UNSPECIFIED |
L'impostazione di codifica del file non è specificata. |
UTF_8 |
La codifica del file è UTF_8. |
ISO_8859_1 |
La codifica del file è ISO_8859_1. |
US_ASCII |
La codifica del file è US_ASCII. |
UTF_16 |
La codifica del file è UTF_16. |
UTF_16LE |
La codifica del file è UTF_16LE. |
UTF_16BE |
La codifica del file è UTF_16BE. |
IdentifierSettings
Impostazioni relative agli identificatori SQL.
Rappresentazione JSON |
---|
{ "outputIdentifierCase": enum ( |
Campi | |
---|---|
outputIdentifierCase |
L'impostazione per controllare le maiuscole/minuscole delle query di output. |
identifierRewriteMode |
Specifica la modalità di riscrittura per gli identificatori SQL. |
IdentifierCase
Il tipo di maiuscole e minuscole dell'identificatore.
Enum | |
---|---|
IDENTIFIER_CASE_UNSPECIFIED |
Il caso dell'identificatore non è specificato. |
ORIGINAL |
Le richieste degli identificatori verranno conservate come le richieste originali. |
UPPER |
Gli identificatori saranno in maiuscolo. |
LOWER |
Gli identificatori saranno in minuscolo. |
IdentifierRewriteMode
La modalità di riscrittura dell'identificatore SQL.
Enum | |
---|---|
IDENTIFIER_REWRITE_MODE_UNSPECIFIED |
La modalità di riscrittura dell'identificatore SQL non è specificata. |
NONE |
Gli identificatori SQL non verranno riscritti. |
REWRITE_ALL |
Tutti gli identificatori SQL verranno riscritti. |
TokenType
Il tipo di dati del token speciale.
Enum | |
---|---|
TOKEN_TYPE_UNSPECIFIED |
Il tipo di token non è specificato. |
STRING |
Tipo di token come stringa. |
INT64 |
Tipo di token come numero intero. |
NUMERIC |
Tipo di token: numerico. |
BOOL |
Il tipo di token è booleano. |
FLOAT64 |
Tipo di token come in virgola mobile. |
DATE |
Tipo di token come data. |
TIMESTAMP |
Tipo di token: timestamp. |
Filtro
Il filtro applicato ai campi dei dettagli della traduzione.
Rappresentazione JSON |
---|
{ "inputFileExclusionPrefixes": [ string ] } |
Campi | |
---|---|
inputFileExclusionPrefixes[] |
L'elenco di prefissi utilizzati per escludere l'elaborazione dei file di input. |
TranslationConfigDetails
La configurazione della traduzione per acquisire le impostazioni necessarie per un'attività di traduzione e un'attività secondaria.
Rappresentazione JSON |
---|
{ "sourceDialect": { object ( |
Campi | |
---|---|
sourceDialect |
Il dialetto dei file di input. |
targetDialect |
Il dialetto di destinazione in cui il motore deve tradurre l'input. |
sourceEnv |
I valori dell'ambiente di origine predefiniti per la traduzione. |
sourceTargetLocationMapping[] |
La mappatura dei percorsi delle località di origine ai percorsi delle località target. |
requestSource |
Indicatore per mostrare l'iniziatore della richiesta di traduzione. |
Campo unione source_location . Il percorso scelto in cui verrà trovata l'origine dei file di input. source_location può essere solo uno dei seguenti: |
|
gcsSourcePath |
Percorso Cloud Storage per una directory di file da tradurre in un'attività. |
Campo unione target_location . Il percorso scelto in cui si troverà la destinazione per i file di output. target_location può essere solo uno dei seguenti: |
|
gcsTargetPath |
Il percorso Cloud Storage in cui riscrivere i file di input corrispondenti. |
Dialetto
Le possibili opzioni di dialetto per la traduzione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione dialect_value . Le possibili opzioni di dialetto rappresentate da questo messaggio. dialect_value può essere solo uno dei seguenti: |
|
bigqueryDialect |
Il dialetto BigQuery |
hiveqlDialect |
Il dialetto HiveQL |
redshiftDialect |
Il dialetto Redshift |
teradataDialect |
Il dialetto Teradata |
oracleDialect |
Il dialetto oracle |
sparksqlDialect |
Il dialetto SparkSQL |
snowflakeDialect |
Il dialetto Snowflake |
netezzaDialect |
Il dialetto Netezza |
azureSynapseDialect |
Il dialetto Azure Synapse |
verticaDialect |
Il dialetto vertico |
sqlServerDialect |
Il dialetto SQL Server |
postgresqlDialect |
Il dialetto Postgresql |
prestoDialect |
Il dialetto Presto |
mysqlDialect |
Il dialetto MySQL |
BigQueryDialect
Questo tipo non contiene campi.
La definizione del dialetto per BigQuery.
HiveQLDialect
Questo tipo non contiene campi.
La definizione del dialetto per HiveQL.
RedshiftDialect
Questo tipo non contiene campi.
La definizione del dialetto per Redshift.
TeradataDialect
La definizione del dialetto per Teradata.
Rappresentazione JSON |
---|
{
"mode": enum ( |
Campi | |
---|---|
mode |
La modalità sub-dialetto Teradata specificata dall'utente. |
Modalità
Le opzioni del sottodialetto per Teradata.
Enum | |
---|---|
MODE_UNSPECIFIED |
Modalità non specificata. |
SQL |
Modalità SQL Teradata. |
BTEQ |
Modalità BTEQ (che include SQL). |
OracleDialect
Questo tipo non contiene campi.
La definizione del dialetto per Oracle.
SparkSQLDialect
Questo tipo non contiene campi.
La definizione del dialetto per SparkSQL.
SnowflakeDialect
Questo tipo non contiene campi.
La definizione del dialetto per Snowflake.
NetezzaDialect
Questo tipo non contiene campi.
La definizione di dialetto per Netezza.
AzureSynapseDialect
Questo tipo non contiene campi.
La definizione del dialetto per Azure Synapse.
VerticaDialect
Questo tipo non contiene campi.
La definizione del dialetto per Vertica.
SQLServerDialect
Questo tipo non contiene campi.
La definizione del dialetto per SQL Server.
PostgresqlDialect
Questo tipo non contiene campi.
La definizione del dialetto per Postgresql.
PrestoDialect
Questo tipo non contiene campi.
La definizione del dialetto per Presto.
MySQLDialect
Questo tipo non contiene campi.
La definizione del dialetto per MySQL.
SourceTargetLocationMapping
Rappresenta una mappatura da un percorso della posizione di origine a un percorso della posizione di destinazione facoltativo.
Rappresentazione JSON |
---|
{ "sourceLocation": { object ( |
Campi | |
---|---|
sourceLocation |
Il percorso della posizione dei dati di origine. |
targetLocation |
Il percorso della posizione dei dati di destinazione. |
SourceLocation
Rappresenta un percorso della posizione che contiene i dati di origine.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione location . La posizione dei dati di origine. location può essere solo uno dei seguenti: |
|
gcsPath |
Percorso Cloud Storage di una directory di file. |
TargetLocation
// Rappresenta un percorso alla posizione che contiene i dati di destinazione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione location . La posizione dei dati di destinazione. location può essere solo uno dei seguenti: |
|
gcsPath |
Percorso Cloud Storage di una directory di file. |
TranslationDetails
I dettagli di traduzione per acquisire le impostazioni necessarie per un job di traduzione.
Rappresentazione JSON |
---|
{ "sourceTargetMapping": [ { object ( |
Campi | |
---|---|
sourceTargetMapping[] |
Il mapping dall'origine all'SQL di destinazione. |
targetBaseUri |
L'URI di base per tutte le scritture nell'archiviazione permanente. |
sourceEnvironment |
I valori dell'ambiente di origine predefiniti per la traduzione. |
targetReturnLiterals[] |
L'elenco di target letterali che verranno restituiti direttamente alla risposta. Ogni voce è composta dal percorso creato, ESCLUSO il percorso di base. Se non specifichi un targetBaseUri, non sarà possibile scrivere nello spazio di archiviazione permanente. |
targetTypes[] |
I tipi di output da generare, ad esempio sql, sqlx, derivazione, analisi e così via. Se non specificati, verrà generato un set predefinito di destinazioni. La generazione di alcuni tipi di target aggiuntivi potrebbe richiedere più tempo. Consulta la documentazione per l'insieme dei tipi di target disponibili. |
SourceTargetMapping
Rappresenta un mapping da un SQL di origine a un SQL di destinazione.
Rappresentazione JSON |
---|
{ "sourceSpec": { object ( |
Campi | |
---|---|
sourceSpec |
L'SQL di origine o il relativo percorso. |
targetSpec |
L'SQL di destinazione o il relativo percorso. |
SourceSpec
Rappresenta un percorso della posizione che contiene i dati di origine.
Rappresentazione JSON |
---|
{ "encoding": string, // Union field |
Campi | |
---|---|
encoding |
Facoltativo. Il campo facoltativo per specificare la codifica dei byte SQL. |
Campo unione source . L'SQL di origine specifico. source può essere solo uno dei seguenti: |
|
baseUri |
L'URI di base di tutti i file da leggere come fonti per la traduzione. |
literal |
Valore letterale di origine. |
Valore letterale
Dati letterali.
Rappresentazione JSON |
---|
{ "relativePath": string, // Union field |
Campi | |
---|---|
relativePath |
Obbligatorio. L'identificatore della voce letterale. |
Campo unione literal_data . I contenuti letterali SQL. literal_data può essere solo uno dei seguenti: |
|
literalString |
Dati stringa letterali. |
literalBytes |
Dati in byte letterali. |
TargetSpec
Rappresenta un percorso della località che contiene i dati di destinazione.
Rappresentazione JSON |
---|
{ "relativePath": string } |
Campi | |
---|---|
relativePath |
Il percorso relativo per i dati di destinazione. Dato il file di origine |
SourceEnvironment
Rappresenta i valori dell'ambiente di origine predefiniti per la traduzione.
Rappresentazione JSON |
---|
{ "defaultDatabase": string, "schemaSearchPath": [ string ], "metadataStoreDataset": string } |
Campi | |
---|---|
defaultDatabase |
Il nome predefinito del database per qualificare completamente gli oggetti SQL quando manca il nome del database. |
schemaSearchPath[] |
Il percorso di ricerca dello schema. Quando negli oggetti SQL manca il nome dello schema, il motore di traduzione cercherà in questo elenco per trovare il valore. |
metadataStoreDataset |
Facoltativo. È richiesto un ID set di dati BigQuery validoQ esistente, ad esempio project-123.metadata_store_123. Se specificato, la traduzione cercherà e leggerà le informazioni di schema richieste da un archivio di metadati in questo set di dati. Se l'archivio di metadati non esiste, la traduzione analizzerà il file di metadati e caricherà le informazioni sullo schema in una tabella temporanea nel set di dati per velocizzare i job di traduzione futuri. |
Stato
Stati possibili di un'attività di migrazione.
Enum | |
---|---|
STATE_UNSPECIFIED |
Lo stato non è specificato. |
PENDING |
L'attività è in attesa dell'orchestrazione. |
ORCHESTRATING |
L'attività è assegnata a un agente di orchestrazione. |
RUNNING |
L'attività è in esecuzione, ovvero le sue attività secondarie sono pronte per l'esecuzione. |
PAUSED |
L'attività è in pausa. Le attività secondarie assegnate possono continuare, ma non verranno programmate nuove attività secondarie. |
SUCCEEDED |
L'attività è stata completata. |
FAILED |
L'attività non è stata completata correttamente. |
MigrationTaskOrchestrationResult
Informazioni aggiuntive dall'agente di orchestrazione una volta completata l'orchestrazione delle attività.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione details . Dettagli specifici per il tipo di attività. details può essere solo uno dei seguenti: |
|
assessmentDetails |
Dettagli specifici dei tipi di attività di valutazione. |
translationTaskResult |
Dettagli specifici per i tipi di attività di traduzione. |
AssessmentOrchestrationResultDetails
Dettagli del risultato dell'orchestrazione di un'attività di valutazione.
Rappresentazione JSON |
---|
{ "outputTablesSchemaVersion": string, "reportUri": string } |
Campi | |
---|---|
outputTablesSchemaVersion |
Facoltativo. La versione utilizzata per gli schemi delle tabelle di output. |
reportUri |
Facoltativo. L'URI del report di Data Studio. |
TranslationTaskResult
Dettagli dei risultati specifici della traduzione dall'attività di migrazione.
Rappresentazione JSON |
---|
{ "translatedLiterals": [ { object ( |
Campi | |
---|---|
translatedLiterals[] |
L'elenco dei valori letterali tradotti. |
reportLogMessages[] |
I record del report CSV aggregato per un flusso di lavoro di migrazione. |
GcsReportLogMessage
Un record nel report CSV aggregato per un flusso di lavoro di migrazione
Rappresentazione JSON |
---|
{ "severity": string, "category": string, "filePath": string, "filename": string, "sourceScriptLine": integer, "sourceScriptColumn": integer, "message": string, "scriptContext": string, "action": string, "effect": string, "objectName": string } |
Campi | |
---|---|
severity |
Gravità del record di traduzione. |
category |
Categoria dell'errore/avviso. Esempio: SyntaxError |
filePath |
Il percorso del file in cui si è verificato l'errore |
filename |
Il nome del file in cui si è verificato l'errore |
sourceScriptLine |
Specifica la riga del testo di origine in cui si è verificato l'errore (in base 0, -1 per i messaggi senza posizione riga). Esempio: 2 |
sourceScriptColumn |
Specifica la colonna dei testi di origine in cui si è verificato l'errore. (in base 0, -1 per i messaggi senza posizione colonna) Esempio: 6 |
message |
Messaggio dettagliato del record. |
scriptContext |
Il contesto dello script (offuscato) in cui si è verificato l'errore |
action |
Categoria dell'errore/avviso. Esempio: SyntaxError |
effect |
Categoria dell'errore/avviso. Esempio: SyntaxError |
objectName |
Nome dell'oggetto interessato nel messaggio di log. |
Stato
Possibili stati del flusso di lavoro di migrazione.
Enum | |
---|---|
STATE_UNSPECIFIED |
Stato del flusso di lavoro non specificato. |
DRAFT |
Il flusso di lavoro è in stato di bozza, ad esempio le attività non sono ancora idonee per l'esecuzione. |
RUNNING |
Flusso di lavoro in esecuzione (le attività sono idonee per l'esecuzione). |
PAUSED |
Flusso di lavoro in pausa. Le attività attualmente in corso possono continuare, ma non verranno programmate altre attività. |
COMPLETED |
Flusso di lavoro completato. Non dovrebbero esserci attività in stato non terminale, ma se lo sono (ad es. chiusura forzata), non verranno pianificate. |
Metodi |
|
---|---|
|
Crea un flusso di lavoro di migrazione. |
|
Elimina un flusso di lavoro di migrazione per nome. |
|
Ottiene un flusso di lavoro di migrazione creato in precedenza. |
|
Elenca il flusso di lavoro di migrazione creato in precedenza. |
|
Avvia un flusso di lavoro di migrazione creato in precedenza. |