- 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
- Litero
- TargetSpec
- Stato
- MigrationTaskOrchestrationResult
- AssessmentOrchestrationResultDetails
- TranslationTaskResult
- GcsReportLogMessage
- Stato
- Metodi
Risorsa: MigrationWorkflow
Un flusso di lavoro di migrazione che specifica cosa è necessario fare 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. Questa opzione può essere impostata in modo da assegnare un nome descrittivo a un flusso di lavoro. Non esiste alcuna garanzia o applicazione dell'unicità. |
tasks |
Le attività in un flusso di lavoro in una mappa denominata. Il nome (ovvero la chiave) non ha significato ed è semplicemente un modo pratico per svolgere un'attività specifica in un flusso di lavoro. |
state |
Solo output. Questo stato del flusso di lavoro. |
createTime |
L'ora in cui è stato creato il flusso di lavoro. |
lastUpdateTime |
L'ora dell'ultimo aggiornamento del flusso di lavoro. |
MigrationTask
Una singola attività per una migrazione, con 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_Azure_MySQL2BQ |
details |
OBSOLETO Utilizza uno dei valori task_details 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à è in stato NON RIUSCITA. |
createTime |
Data e ora di creazione dell'attività. |
lastUpdateTime |
Data e ora dell'ultimo aggiornamento dell'attività. |
orchestrationResult |
Solo output. Informazioni aggiuntive sull'orchestrazione. |
resourceErrorDetails[] |
Solo output. Fornisce i dettagli sugli errori e sui problemi riscontrati durante l'elaborazione dell'attività. La presenza di dettagli dell'errore non indica che l'attività non è riuscita. |
resourceErrorCount |
Il numero o le risorse con errori. Nota: questo non è il numero totale di errori, in quanto ogni risorsa può avere più di un errore. Viene utilizzato per indicare il troncamento in quanto ha un valore |
metrics[] |
Le metriche per l'attività. |
Campo di 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 batch di SQL. |
translationConfigDetails |
Configurazione delle attività per la traduzione SQL batch/offline CW. |
translationDetails |
Dettagli 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. Il 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 quindi 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 |
Il percorso Cloud Storage per i file di input di traduzione. |
outputPath |
Il percorso Cloud Storage per i file di output della traduzione. |
filePaths[] |
File di 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 acquisisce token speciali da sostituire durante la traduzione. 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 una query non valida da analizzare. Questa mappa verrà applicata per annotare i token speciali con i tipi per consentire al parser di capire come analizzarli nella 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 visualizzare gli 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à visualizzato un errore. |
Campo di 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 relative all'attività di traduzione specifica 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 |
Il percorso di Cloud Storage da utilizzare come percorso predefinito per i file che non sono altrimenti specificati nella mappa di sostituzione dei file. |
fileReplacementMap |
Mappa i percorsi locali utilizzati negli script BTEQ (le chiavi) ai percorsi in Cloud Storage che dovrebbero essere utilizzati 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 di un file di input e di un output da tradurre in un'attività secondaria.
Rappresentazione JSON |
---|
{ "inputPath": string, "outputPath": string } |
Campi | |
---|---|
inputPath |
Il percorso Cloud Storage di un file da tradurre in un'attività secondaria. |
outputPath |
Il percorso Cloud Storage in cui scrivere il file di input corrispondente. |
FileEncoding
I tipi di codifica dei file.
Enum | |
---|---|
FILE_ENCODING_UNSPECIFIED |
Impostazione di codifica del file non specificata. |
UTF_8 |
La codifica dei file è UTF_8. |
ISO_8859_1 |
La codifica dei file è ISO_8859_1. |
US_ASCII |
La codifica dei file è US_ASCII. |
UTF_16 |
La codifica dei file è UTF_16. |
UTF_16LE |
La codifica dei file è UTF_16LE. |
UTF_16BE |
La codifica dei file è UTF_16BE. |
IdentifierSettings
Impostazioni relative agli identificatori SQL.
Rappresentazione JSON |
---|
{ "outputIdentifierCase": enum ( |
Campi | |
---|---|
outputIdentifierCase |
L'impostazione per controllare le maiuscole e le minuscole degli identificatori delle query di output. |
identifierRewriteMode |
Specifica la modalità di riscrittura per gli identificatori SQL. |
IdentifierCase
Il tipo di caso dell'identificatore.
Enum | |
---|---|
IDENTIFIER_CASE_UNSPECIFIED |
L'identificatore maiuscole e minuscole non è specificato. |
ORIGINAL |
I casi degli identificatori verranno mantenuti come quelli originali. |
UPPER |
Gli identificatori sono in maiuscolo. |
LOWER |
Gli identificatori sono 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 come numerico. |
BOOL |
Tipo di token come booleano. |
FLOAT64 |
Tipo di token come numero in virgola mobile. |
DATE |
Tipo di token come data. |
TIMESTAMP |
Tipo di token come 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 di 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 predefiniti dell'ambiente di origine per la traduzione. |
sourceTargetLocationMapping[] |
La mappatura dai percorsi delle località di origine ai percorsi delle località di destinazione. |
requestSource |
L'indicatore per mostrare l'iniziatore della richiesta di traduzione. |
Campo di 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 |
Il percorso Cloud Storage di una directory di file da tradurre in un'attività. |
Campo di unione target_location . Il percorso scelto in cui verrà trovata la destinazione per i file di output. target_location può essere solo uno dei seguenti: |
|
gcsTargetPath |
Il percorso Cloud Storage in cui scrivere i file di input corrispondenti. |
Dialetto
Le possibili opzioni di dialetto per la traduzione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione dialect_value . Le opzioni di dialetto possibili 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 di Azure Synapse |
verticaDialect |
Il dialetto Vertica |
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 |
Modalità di subaccount di Teradata specificata dall'utente. |
Modalità
Le opzioni dei sottodialetti per Teradata.
Enum | |
---|---|
MODE_UNSPECIFIED |
Modalità non specificata. |
SQL |
modalità SQL di 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 di Snowflake.
NetezzaDialect
Questo tipo non contiene campi.
La definizione del dialetto di 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 dei dati di destinazione. |
SourceLocation
Rappresenta un percorso per la località che contiene i dati di origine.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione location . La posizione dei dati di origine. location può essere solo uno dei seguenti: |
|
gcsPath |
Il percorso Cloud Storage di una directory di file. |
TargetLocation
// Rappresenta un percorso della località che contiene i dati di destinazione.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione location . La posizione dei dati di destinazione. location può essere solo uno dei seguenti: |
|
gcsPath |
Il percorso Cloud Storage di una directory di file. |
TranslationDetails
I dettagli della traduzione per acquisire le impostazioni necessarie per un job di traduzione.
Rappresentazione JSON |
---|
{ "sourceTargetMapping": [ { object ( |
Campi | |
---|---|
sourceTargetMapping[] |
Il mapping dall'SQL di origine a quello di destinazione. |
targetBaseUri |
L'URI di base per tutte le scritture nell'archiviazione permanente. |
sourceEnvironment |
I valori predefiniti dell'ambiente di origine per la traduzione. |
targetReturnLiterals[] |
L'elenco di destinazioni letterali che verranno restituite direttamente alla risposta. Ogni voce è composta dal percorso creato, ESCLUDE il percorso di base. Se non fornisci un valore 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 specificato, verrà generato un set predefinito di target. La generazione di alcuni tipi di target aggiuntivi potrebbe essere più lenta. Consulta la documentazione per l'insieme di tipi di target disponibili. |
SourceTargetMapping
Rappresenta una mappatura da un'istanza 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 per la località 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 di 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 origini 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 di unione literal_data . I contenuti SQL letterali. literal_data può essere solo uno dei seguenti: |
|
literalString |
Dati stringa letterali. |
literalBytes |
Dati in byte letterali. |
TargetSpec
Rappresenta un percorso per la località che contiene i dati di destinazione.
Rappresentazione JSON |
---|
{ "relativePath": string } |
Campi | |
---|---|
relativePath |
Il percorso relativo per i dati di destinazione. Data il file di origine |
SourceEnvironment
Rappresenta i valori predefiniti dell'ambiente di origine per la traduzione.
Rappresentazione JSON |
---|
{ "defaultDatabase": string, "schemaSearchPath": [ string ], "metadataStoreDataset": string } |
Campi | |
---|---|
defaultDatabase |
Il nome del database predefinito 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à nell'elenco per trovare il valore. |
metadataStoreDataset |
Facoltativo. È richiesto un ID set di dati BigQuery valido Q 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 dei metadati e caricherà le informazioni sullo schema in una tabella temporanea nel set di dati per velocizzare i job di traduzione futuri. |
Stato
Possibili stati di un'attività di migrazione.
Enum | |
---|---|
STATE_UNSPECIFIED |
Lo stato non è specificato. |
PENDING |
L'attività è in attesa dell'orchestrazione. |
ORCHESTRATING |
L'attività viene assegnata a un orchestratore. |
RUNNING |
L'attività è in esecuzione, pertanto le relative attività secondarie sono pronte per l'esecuzione. |
PAUSED |
Quest'attività è in pausa. Le attività secondarie assegnate possono continuare, ma non verranno pianificate nuove attività secondarie. |
SUCCEEDED |
L'attività è stata completata correttamente. |
FAILED |
L'attività non è stata completata correttamente. |
MigrationTaskOrchestrationResult
Informazioni aggiuntive dall'orchestratore quando questa operazione è stata completata con l'orchestrazione delle attività.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione details . Dettagli specifici per il tipo di attività. details può essere solo uno dei seguenti: |
|
assessmentDetails |
Dettagli specifici per i 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 della tabella di output. |
reportUri |
Facoltativo. L'URI del report 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 a 0, -1 per i messaggi senza posizione della riga). Esempio: 2 |
sourceScriptColumn |
Specifica la colonna dei testi di origine in cui si è verificato l'errore. (in base a 0, -1 per i messaggi senza posizione della colonna): 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 |
Il nome dell'oggetto interessato nel messaggio di log. |
Stato
Possibili stati del flusso di lavoro di migrazione.
Enum | |
---|---|
STATE_UNSPECIFIED |
Lo stato del flusso di lavoro non è specificato. |
DRAFT |
Il flusso di lavoro è in stato di bozza, ad esempio le attività non sono ancora idonee all'esecuzione. |
RUNNING |
Il flusso di lavoro è in esecuzione (ossia le attività sono idonee per l'esecuzione). |
PAUSED |
Flusso di lavoro in pausa. Le attività attualmente in corso potrebbero continuare, ma non verranno pianificate ulteriori attività. |
COMPLETED |
Flusso di lavoro completato. Non dovrebbero esserci attività in stato non terminale.Tuttavia, se lo sono (ad es. terminazione forzata), non verranno pianificate. |
Metodi |
|
---|---|
|
Crea un flusso di lavoro di migrazione. |
|
Elimina un flusso di lavoro di migrazione per nome. |
|
Recupera 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. |