Questa pagina è stata tradotta dall'API Cloud Translation.

Trasforma le traduzioni SQL utilizzando i file YAML di configurazione

Questo documento mostra come utilizzare i file YAML di configurazione per trasformare le query durante la migrazione a BigQuery. Fornisce linee guida per creare i tuoi file YAML di configurazione e fornire esempi per vari trasformazioni di traduzione supportate da questa funzionalità.

Quando utilizzi il traduttore SQL interattivo di BigQuery, l'API BigQuery Migration o esegui una traduzione SQL batch, puoi fornire file di configurazione YAML per modificare una traduzione di query SQL. L'uso dei file YAML di configurazione consente un'ulteriore personalizzazione quando e tradurre le query SQL dal database di origine.

Puoi specificare un file YAML di configurazione da utilizzare in una traduzione SQL nel nei seguenti modi:

Se utilizzi il traduttore SQL interattivo, specifica il percorso del file del file di configurazione o dell'ID job di traduzione batch nelle impostazioni di traduzione.
Se utilizzi l'API BigQuery Migration, inserisci il parametro YAML della configurazione nello stesso bucket Cloud Storage dell'SQL di input .
Se stai eseguendo una traduzione SQL batch, inserisci il file YAML nello stesso bucket Cloud Storage dei file SQL di input.
Se utilizzi il client Python per le traduzioni collettive, colloca il file YAML di configurazione nella cartella di input della traduzione locale.

Il traduttore SQL interattivo, l'API BigQuery Migration, il traduttore SQL batch e il client Python di traduzione batch supporta l'uso di più file YAML di configurazione in un unico job di traduzione. Consulta: Applicazione di più configurazioni YAML per ulteriori informazioni.

Requisiti del file YAML di configurazione

Prima di creare un file YAML di configurazione, esamina le seguenti informazioni per assicurarti che il file YAML sia compatibile con BigQuery Migration Service:

Devi caricare i file YAML di configurazione nella directory principale del bucket Cloud Storage contenente i file di input per la traduzione SQL. Per informazioni su come creare bucket e caricare file su Cloud Storage, consulta Creare bucket e Caricare oggetti da un file system.
Le dimensioni di un singolo file YAML di configurazione non devono superare 1 MB.
Le dimensioni totali di tutti i file YAML di configurazione utilizzati in una singola query il job di traduzione non deve superare i 4 MB.
Se utilizzi la sintassi regex per la corrispondenza dei nomi, utilizza RE2/J.
Tutti i nomi dei file YAML di configurazione devono includere un'estensione.config.yaml, ad esempio change-case.config.yaml.
- config.yaml da solo non è un nome valido per il file di configurazione.

Linee guida per creare un file YAML di configurazione

Questa sezione fornisce alcune linee guida generali per creare un file YAML di configurazione:

Ogni file di configurazione deve contenere un'intestazione che specifichi il tipo configurazione. Il tipo object_rewriter viene utilizzato per specificare le traduzioni SQL in di configurazione YAML. L'esempio seguente utilizza object_rewriter per trasformare un nome in maiuscolo:

type: object_rewriter
global:
  case:
    all: UPPERCASE

Selezione delle entità

Per eseguire trasformazioni specifiche dell'entità, specifica l'entità nel di configurazione del deployment. Tutte le proprietà match sono facoltative; utilizza solo le proprietà match necessarie per una trasformazione. Il seguente file YAML di configurazione mostra le proprietà da abbinare per selezionare entità specifiche:

match:
  db: <literal_name>
  schema: <literal_name>
  relation: <literal_name>
  attribute: <literal_name>
  dbRegex: <regex>
  schemaRegex: <regex>
  relationRegex: <regex>
  attributeRegex: <regex>

Descrizione di ogni proprietà match:

db: il componente project_id.
schema: il componente del set di dati.
relation: il componente della tabella.
attribute: il componente della colonna. Valido solo per la selezione degli attributi
dbRegex: corrisponde a una proprietà db con un'espressione regolare (Anteprima).
schemaRegex: associa le proprietà schema alle espressioni regolari (anteprima).
relationRegex: abbina le proprietà relation con espressioni regolari (Anteprima).
attributeRegex: abbina attribute proprietà con la normale le espressioni regolari. Valido solo per la selezione degli attributi (Anteprima).

Ad esempio, il seguente file YAML di configurazione specifica le proprietà match per selezionare la tabella testdb.acme.employee per una trasformazione della tabella provvisoria.

type: object_rewriter
relation:
-
  match:
    db: testdb
    schema: acme
    relation: employee
  temporary: true

Puoi utilizzare dbRegex, schemaRegex, relationRegex e attributeRegex per specificare espressioni regolari in modo da selezionare un sottoinsieme di le entità. L'esempio seguente modifica tutti dallo schema tmp_schema in testdb a quello temporaneo, purché il nome inizia con tmp_:

type: object_rewriter
relation:
-
  match:
    schema: tmp_schema
    relationRegex: "tmp_.*"
  temporary: true

Sia le proprietà letterali che regex vengono associate senza distinzione tra maiuscole e minuscole. Puoi applicare la corrispondenza sensibile alle maiuscole utilizzando un regex con un flag i disabilitato, come mostrato nell'esempio seguente:

match:
  relationRegex: "(?-i:<actual_regex>)"

Puoi anche specificare entità qualificate utilizzando una stringa corta equivalente a riga di comando. Una sintassi a stringa corta prevede esattamente tre (per la selezione delle relazioni) o quattro (per la selezione degli attributi) nome segmenti delimitati da punti, come esempio testdb.acme.employee. I segmenti vengono poi interpretati internamente come se fossero stati trasmessi rispettivamente come db, schema, relation e attribute. Ciò significa che i nomi vengono abbinati in modo letterale, pertanto le espressioni regolari non sono consentite nella sintassi breve. L'esempio seguente mostra l'utilizzo di stringhe brevi per specificare un'entità valida in un file YAML di configurazione:

type: object_rewriter
relation:
-
  match : "testdb.acme.employee"
  temporary: true

Se il nome di una tabella contiene un punto, non puoi specificarlo utilizzando una breve a riga di comando. In questo caso, devi utilizzare una corrispondenza di oggetti. L'esempio seguente imposta la tabella testdb.acme.stg.employee come temporanea:

type: object_rewriter
relation:
-
  match:
    db: testdb
    schema: acme
    relation: stg.employee
  temporary: true

Il file YAML di configurazione accetta key come alias per match.

Database predefinito

Alcuni dialetti SQL di input, in particolare Teradata, non supportano database-name nella nome qualificato. In questo caso, il modo più semplice per associare le entità è omettere la proprietà db in match.

Tuttavia, puoi impostare la proprietà default_database di BigQuery Migration Service e utilizzare il database predefinito in match.

Tipi di attributi target supportati

Puoi utilizzare il file YAML di configurazione per eseguire trasformazioni del tipo di attributo, ovvero trasformare il tipo di dati di una colonna dal tipo di origine a un tipo di destinazione. La di configurazione YAML supporta i seguenti tipi di destinazione:

BOOLEAN
TINYINT
SMALLINT
INTEGER
BIGINT
FLOAT
DOUBLE
NUMERIC (supporta la precisione e la scala facoltative, ad esempio NUMERIC(18, 2))
TIME
TIMETZ
DATE
DATETIME
TIMESTAMP
TIMESTAMPTZ
CHAR (supporta la precisione facoltativa, ad esempio CHAR(42))
VARCHAR (supporta la precisione facoltativa, ad esempio VARCHAR(42))

Esempi YAML di configurazione

Questa sezione fornisce esempi per creare vari file YAML di configurazione da utilizzare con le traduzioni SQL. Ogni esempio illustra la sintassi YAML trasformare la traduzione SQL in modi specifici, insieme a una breve descrizione. Ogni esempio fornisce anche i contenuti di un file teradata-input.sql o hive-input.sql e di un file bq-output.sql in modo da poter confrontare gli effetti di un file YAML di configurazione su una traduzione di query SQL BigQuery.

I seguenti esempi utilizzano Teradata o Hive come dialetto SQL di input e BigQuery SQL come dialetto di output. Le seguenti esempi utilizzano anche testdb come database predefinito e testschema come del percorso di ricerca schema.

Modificare le maiuscole/minuscole del nome dell'oggetto

Il seguente file YAML di configurazione modifica le lettere maiuscole o minuscole dei nomi degli oggetti:

type: object_rewriter
global:
  case:
    all: UPPERCASE
    database: LOWERCASE
    attribute: LOWERCASE

Una traduzione SQL con questo file YAML di configurazione potrebbe avere il seguente aspetto:

`teradata-input.sql`	create table x(a int); select * from x;
`bq-output.sql`	CREATE TABLE testdb.TESTSCHEMA.X ( a INT64 ) ; SELECT X.a FROM testdb.TESTSCHEMA.X ;

Creare una tabella temporanea

Il seguente codice YAML della configurazione modifica una tabella normale in una tabella:

type: object_rewriter
relation:
  -
    match: "testdb.testschema.x"
    temporary: true

Una traduzione SQL con questo file YAML di configurazione potrebbe avere il seguente aspetto:

`teradata-input.sql`	create table x(a int);
`bq-output.sql`	CREATE TEMPORARY TABLE x ( a INT64 ) ;

Crea una tabella temporanea

Il seguente codice YAML di configurazione modifica una tabella normale in un tempo temporaneo tabella con un Scadenza 60 secondi.

type: object_rewriter
relation:
  -
    match: "testdb.testschema.x"
    ephemeral:
      expireAfterSeconds: 60

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

`teradata-input.sql`	create table x(a int);
`bq-output.sql`	CREATE TABLE testdb.testschema.x ( a INT64 ) OPTIONS( expiration_timestamp=timestamp_add(current_timestamp(), interval 60 SECOND) );

Imposta la scadenza della partizione

Il seguente file YAML di configurazione modifica la scadenza di una tabella partitioned in 1 giorno:

type: object_rewriter
relation:
  -
    match: "testdb.testschema.x"
    partitionLifetime:
      expireAfterSeconds: 86400

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

`teradata-input.sql`	create table x(a int, b int) partition by (a);
`bq-output.sql`	CREATE TABLE testdb.testschema.x ( a INT64, b INT64 ) CLUSTER BY a OPTIONS( partition_expiration_days=1 );

Modificare la posizione o il formato esterno di una tabella

Il seguente codice YAML di configurazione modifica la posizione esterna e la formazione per una tabella:

type: object_rewriter
relation:
  -
    match: "testdb.testschema.x"
    external:
      locations: "gs://path/to/department/files"
      format: ORC

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

`teradata-input.sql`	create table x(a int);
`bq-output.sql`	CREATE EXTERNAL TABLE testdb.testschema.x ( a INT64 ) OPTIONS( format='ORC', uris=[ 'gs://path/to/department/files' ] );

Imposta o modifica la descrizione della tabella

Il seguente YAML di configurazione imposta la descrizione di una tabella:

type: object_rewriter
relation:
  -
    match: "testdb.testschema.x"
    description:
      text: "Example description."

Una traduzione SQL con questo file YAML di configurazione potrebbe avere il seguente aspetto:

`teradata-input.sql`	create table x(a int);
`bq-output.sql`	CREATE TABLE testdb.testschema.x ( a INT64 ) OPTIONS( description='Example description.' );

Imposta o modifica il partizionamento delle tabelle

Il seguente codice YAML di configurazione modifica lo schema di partizionamento di una tabella:

type: object_rewriter
relation:
  -
    match: "testdb.testschema.x"
    partition:
      simple:
        add: [a]
  -
    match: "testdb.testschema.y"
    partition:
      simple:
        remove: [a]

Una traduzione SQL con questo file YAML di configurazione potrebbe avere il seguente aspetto:

teradata-input.sql

    create table x(a date, b int);
    create table y(a date, b int) partition by (a);

bq-output.sql

    CREATE TABLE testdb.testschema.x
    (
      a DATE,
      b INT64
    )
    PARTITION BY a;
    CREATE TABLE testdb.testschema.y
    (
      a DATE,
      b INT64
    )
    ;

Impostare o modificare il clustering delle tabelle

Il seguente file YAML di configurazione modifica lo schema di clustering di una tabella:

type: object_rewriter
relation:
  -
    match: "testdb.testschema.x"
    clustering:
      add: [a]
  -
    match: "testdb.testschema.y"
    clustering:
      remove: [b]

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

hive-input.sql

    create table x(a int, b int);
    create table y(a int, b int) clustered by (b) into 16 buckets;

bq-output.sql

    CREATE TABLE testdb.testschema.x
    (
      a INT64,
      b INT64
    )
    CLUSTER BY a;
    CREATE TABLE testdb.testschema.y
    (
      a INT64,
      b INT64
    )
    ;

Modificare il tipo di un attributo di colonna

Il seguente file YAML di configurazione modifica il tipo di dati di un attributo di una colonna:

type: object_rewriter
attribute:
  -
    match:
      db: testdb
      schema: testschema
      attributeRegex: "a+"
    type:
      target: NUMERIC(10,2)

Puoi trasformare il tipo di dati di origine in uno dei tipi di attributi target supportati.

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

`teradata-input.sql`	create table x(a int, b int, aa int);
`bq-output.sql`	CREATE TABLE testdb.testschema.x ( a NUMERIC(31, 2), b INT64, aa NUMERIC(31, 2) ) ;

Aggiungi una connessione al lake di dati esterno

Il seguente codice YAML di configurazione contrassegna la tabella di origine come esterna che punta a dati archiviati in un data lake esterno, specificati da un e la connessione al lake.

type: object_rewriter
relation:
-
  key: "testdb.acme.employee"
  external:
    connection_id: "connection_test"

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

`hive-input.sql`	CREATE TABLE x ( a VARCHAR(150), b INT );
`bq-output.sql`	CREATE EXTERNAL TABLE x ( a STRING, b INT64 ) WITH CONNECTION `connection_test` OPTIONS( );

Modificare la codifica dei caratteri di un file di input

Per impostazione predefinita, BigQuery Migration Service tenta di rilevare automaticamente la codifica dei caratteri dei file di input. Nei casi in cui BigQuery Migration Service potrebbero identificare erroneamente la codifica di un file, puoi utilizzare un file YAML per specificare la codifica dei caratteri in modo esplicito.

Il seguente file YAML di configurazione specifica la codifica esplicita dei caratteri del file di input come ISO-8859-1.

type: experimental_input_formats
formats:
- source:
    pathGlob: "*.sql"
  contents:
    raw:
      charset: iso-8859-1

Conversione di tipo globale

Il seguente file YAML di configurazione modifica un tipo di dati in un altro in tutti gli script e specifica un tipo di dati di origine da evitare nello script transpiled. È diverso da Modifica il tipo di attributo di una colonna. di configurazione, in cui viene modificato solo il tipo di dati per un singolo attributo.

BigQuery supporta le seguenti conversioni di tipo di dati:

Da DATETIME a TIMESTAMP
Da TIMESTAMP a DATETIME (accetta il fuso orario facoltativo)
Da TIMESTAMP WITH TIME ZONE a DATETIME (accetta il fuso orario facoltativo)
Da CHAR a VARCHAR

Nel seguente esempio, il file YAML di configurazione converte un tipo di dati TIMESTAMP in DATETIME.

type: experimental_object_rewriter
global:
  typeConvert:
    timestamp: DATETIME

In dialetti come Teradata, le funzioni relative a data e ora come current_date, current_time o current_timestamp restituiscono i timestamp in base al fuso orario configurato, locale o della sessione. BigQuery, invece, restituisce sempre i timestamp in UTC. Per garantire un comportamento coerente tra i due dialetti, è necessario configurare il fuso orario di conseguenza.

Nell'esempio seguente, il file YAML di configurazione converte un tipo di dati TIMESTAMP e un tipo di dati TIMESTAMP WITH TIME ZONE in DATETIME, con il fuso orario di destinazione impostato su Europe/Paris.

type: experimental_object_rewriter
global:
  typeConvert:
    timestamp:
      target: DATETIME
      timezone: Europe/Paris
    timestamptz:
      target: DATETIME
      timezone: Europe/Paris

Una traduzione SQL con questo file YAML di configurazione potrebbe avere il seguente aspetto:

teradata-input.sql

      create table x(a timestamp);
      select a from x where a > current_timestamp(0);

bq-output.sql

      CREATE TABLE x
      (
        a TIMESTAMP
      )
      ;
      SELECT
          x.a
        FROM
          test.x
        WHERE x.a > datetime_trunc(current_datetime('Europe/Paris'), SECOND)
      ;

Seleziona la modifica dell'estratto conto

La configurazione YAML seguente modifica la proiezione a stella, GROUP BY e Clausole ORDER BY nelle istruzioni SELECT.

starProjection supporta le seguenti configurazioni:

ALLOW
PRESERVE (valore predefinito)
EXPAND

groupBy e orderBy supportano le seguenti configurazioni:

EXPRESSION
ALIAS
INDEX

Nell'esempio seguente, il file YAML di configurazione configura la proiezione stellata su EXPAND.

type: experimental_statement_rewriter
select:
  starProjection: EXPAND

Una traduzione SQL con questo file YAML di configurazione potrebbe avere il seguente aspetto:

`teradata-input.sql`	create table x(a int, b TIMESTAMP); select * from x;
`bq-output.sql`	CREATE TABLE x ( a INT64, b DATETIME ) ; SELECT x.a x.b FROM x ;

Specifica della funzione definita dall'utente

Il seguente file YAML di configurazione specifica la firma delle funzioni definite dall'utente (UDF) utilizzate negli script di origine. Proprio come i file ZIP dei metadati, Le definizioni delle funzioni definite dall'utente possono aiutare a produrre una traduzione più accurata dell'input script.

type: metadata
udfs:
  - "date parse_short_date(dt int)"

Una traduzione SQL con questo file YAML di configurazione potrebbe avere il seguente aspetto:

`teradata-input.sql`	create table x(dt int); select parse_short_date(dt) + 1 from x;
`bq-output.sql`	CREATE TABLE x ( dt INT64 ) ; SELECT date_add(parse_short_date(x.dt), interval 1 DAY) FROM x ;

Impostazione della severità della precisione decimale

Per impostazione predefinita, BigQuery Migration Service aumenta la precisione numerica al valore massimo precisione disponibile per una data scala. Il seguente file YAML di configurazione sostituisce questo comportamento configurando la severità della precisione in modo da mantenere la precisione decimale dell'istruzione di origine.

type: experimental_statement_rewriter
common:
  decimalPrecision: STRICT

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

`teradata-input.sql`	create table x(a decimal(3,0));
`bq-output.sql`	CREATE TABLE x ( a NUMERIC(3) ) ;

Mappatura dei nomi di output

Puoi utilizzare YAML di configurazione per mappare i nomi degli oggetti SQL. Puoi modificare parti diverse del nome a seconda dell'oggetto da mappare.

Mappatura dei nomi statici

Utilizza la mappatura dei nomi statica per mappare il nome di un'entità. Se vuoi solo modificare parti specifiche del nome, mantenendo invariate altre parti del nome, includi solo le parti che devono essere modificate.

Il seguente codice YAML di configurazione cambia il nome della tabella da Da my_db.my_schema.my_table a my_new_db.my_schema.my_new_table.

type: experimental_object_rewriter
relation:
-
  match: "my_db.my_schema.my_table"
  outputName:
    database: "my_new_db"
    relation: "my_new_table"

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

`teradata-input.sql`	create table my_db.my_schema.my_table(a int);
`bq-output.sql`	CREATE TABLE my_new_db.my_schema.my_new_table ( a INT64 )

Mappatura dei nomi dinamica

Utilizza la mappatura dei nomi dinamica per modificare più oggetti contemporaneamente e creare nuovi nomi in base agli oggetti mappati.

Il seguente file YAML di configurazione cambia il nome di tutte le tabelle aggiungendo il prefisso stg_ a quelle che appartengono allo schema staging e poi sposta queste tabelle nello schema production.

type: experimental_object_rewriter
relation:
-
  match:
    schema: staging
  outputName:
    schema: production
    relation: "stg_${relation}"

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

`teradata-input.sql`	create table staging.my_table(a int);
`bq-output.sql`	CREATE TABLE production.stg_my_table ( a INT64 ) ;

Specificare il database predefinito e il percorso di ricerca dello schema

Il seguente file YAML di configurazione specifica un database predefinito e un percorso di ricerca dello schema.

type: environment
session:
  defaultDatabase: myproject
  schemaSearchPath: [myschema1, myschema2]

Una traduzione SQL con questo file YAML di configurazione potrebbe essere simile seguenti:

`teradata-input.sql`	SELECT * FROM database.table SELECT * FROM table1
`bq-output.sql`	SELECT * FROM myproject.database.table. SELECT * FROM myproject.myschema1.table1

Riscrittura nome output globale

Il seguente file YAML di configurazione modifica i nomi di output di tutti gli oggetti (database, schema, relazione e attributi) nello script in base alle regole configurate.

type: experimental_object_rewriter
global:
  outputName:
    regex:
      - match: '\s'
        replaceWith: '_'
      - match: '>='
        replaceWith: 'gte'
      - match: '^[^a-zA-Z_].*'
        replaceWith: '_$0'

Una traduzione SQL con questo file YAML di configurazione potrebbe avere il seguente aspetto:

`teradata-input.sql`	create table "test special chars >= 12"("42eid" int, "custom column" varchar(10));
`bq-output.sql`	CREATE TABLE test_special_chars_employees_gte_12 ( _42eid INT64, custom_column STRING ) ;

Ottimizza e migliora le prestazioni del linguaggio SQL tradotto

Le trasformazioni facoltative possono essere applicate al codice SQL tradotto per introdurre modifiche che possono migliorare la query in termini di prestazioni o costi. Questi le ottimizzazioni dipendono strettamente dal caso in cui si verifichi la richiesta e devono essere valutate rispetto a Output SQL per valutare il loro effetto effettivo sulle prestazioni.

Il seguente file YAML di configurazione abilita le trasformazioni facoltative. La configurazione accetta un elenco di ottimizzazioni e, per le ottimizzazioni che accettano parametri, una sezione con valori facoltativi dei parametri.

type: experimental_optimizer
transformations:
  - name: PRECOMPUTE_INDEPENDENT_SUBSELECTS
  - name: REWRITE_CTE_TO_TEMP_TABLE
    parameters:
      threshold: 1

Ottimizzazione	Parametro facoltativo	Descrizione
`PRECOMPUTE_INDEPENDENT_SUBSELECTS`	`scope: [PREDICATE, PROJECTION]`	Riscrive la query aggiungendo un'istruzione `DECLARE` per sostituire una nelle clausole `PREDICATE` o `PROJECTION` con una variabile precalcolata. Sarà identificato come un predicato statico che per ridurre la quantità di dati letti. Se l'ambito viene omesso, il valore predefinito è `PREDICATE` (ovvero `WHERE` e clausola `JOIN-ON`). Estrazione di una sottoquery scalare in un'istruzione `DECLARE` il predicato originale diventerà statico e quindi idoneo per una migliore esecuzione predittiva dell'inventario. Questa ottimizzazione introdurrà nuove istruzioni SQL.
`REWRITE_CTE_TO_TEMP_TABLE`	`threshold: N`	Riscrive le espressioni di tabella comuni (CTE) in tabelle temporanee quando ne esistono di più di `N` fa riferimento alla stessa espressione di tabella comune. Questo riduce la complessità delle query e forza l'esecuzione singola dell'espressione di tabella comune. Se `N` viene omesso, il valore predefinito è 4. Consigliamo di utilizzare questa ottimizzazione quando si fa riferimento più volte a CTE non banali. L'introduzione di tabelle temporanee comporta un overhead che potrebbe essere maggiore rispetto alle eventuali molteplici esecuzioni di un'espressione a tabella con complessità o cardinalità ridotte. Questa ottimizzazione introdurrà nuove istruzioni SQL.
`REWRITE_ZERO_SCALE_NUMERIC_AS_INTEGER`	`bigint: N`	Riscrive gli attributi `NUMERIC/BIGNUMERIC` con scala zero in Tipo `INT64` se la precisione è compresa tra `N`. Se `N` viene omesso, il valore predefinito è `18`. Ti consigliamo di utilizzare questa ottimizzazione quando traduci da dialetti di origine che non includono tipi di numeri interi. La modifica dei tipi di colonna richiede la revisione di tutti gli utilizzi a valle per verificare la compatibilità dei tipi e le modifiche semantiche. Ad esempio, le divisioni frazionarie divisioni intere, codice che prevede valori numerici
`DROP_TEMP_TABLE`		Aggiunge istruzioni `DROP TABLE` per tutte le tabelle temporanee create in uno script e non vengano abbandonati alla fine. Questo riduce lo spazio di archiviazione periodo di fatturazione per la tabella temporanea da 24 ore allo script in esecuzione nel tempo. Questa ottimizzazione introdurrà nuove istruzioni SQL. Ti consigliamo di utilizzare questa ottimizzazione quando non viene eseguito alcun accesso alle tabelle temporanee per ulteriori elaborazioni al termine dell'esecuzione dello script. Questa ottimizzazione introdurrà nuove istruzioni SQL.
`REGEXP_CONTAINS_TO_LIKE`		Riscrive alcune categorie di `REGEXP_CONTAINS` pattern corrispondenti alle espressioni `LIKE`. Consigliamo di utilizzare questa ottimizzazione quando non si basa nessun altro processo, come la sostituzione di macro, sui valori letterali del pattern di espressioni regolari che vengono conservati nell'SQL di output.
`ADD_DISTINCT_TO_SUBQUERY_IN_SET_COMPARISON`		Aggiunge la clausola `DISTINCT` alle sottoquery utilizzate come valore impostato per Operatore `[NOT] IN`. Ti consigliamo di utilizzare questa ottimizzazione quando la cardinalità (numero distinto di valori) del il risultato della sottoquery è significativamente inferiore al numero di valori. Se questo precondizionatore non viene soddisfatto, la trasformazione può avere effetti negativi sul rendimento.

Applicazione di più configurazioni YAML

Quando specifichi un file YAML di configurazione in un file SQL batch o interattivo puoi selezionare più file YAML di configurazione in un un job di traduzione per riflettere più trasformazioni. Se sono presenti più configurazioni conflitto, una trasformazione potrebbe prevalere su un'altra. Ti consigliamo di utilizzare diversi tipi di impostazioni di configurazione in ogni file per evitare trasformazioni in conflitto nella stessa attività di traduzione.

L'esempio seguente elenca due file YAML di configurazione separati per un singolo job di traduzione SQL, uno per modificare l'attributo di una colonna, e l'altra per impostare la tabella come temporanea:

change-type-example.config.yaml:

type: object_rewriter
attribute:
  -
    match: "testdb.testschema.x.a"
    type:
      target: NUMERIC(10,2)

make-temp-example.config.yaml:

type: object_rewriter
relation:
  -
    match: "testdb.testschema.x"
    temporary: true

Una traduzione SQL con questi due file YAML di configurazione potrebbe essere seguenti:

`teradata-input.sql`	create table x(a int);
`bq-output.sql`	CREATE TEMPORARY TABLE x ( a NUMERIC(31, 2) ) ;

Trasforma le traduzioni SQL utilizzando i file YAML di configurazione

Requisiti del file YAML di configurazione

Linee guida per creare un file YAML di configurazione

Intestazione

Selezione delle entità

Database predefinito

Tipi di attributi target supportati

Esempi YAML di configurazione

Modificare le maiuscole/minuscole del nome dell'oggetto

Creare una tabella temporanea

Crea una tabella temporanea

Imposta la scadenza della partizione

Modificare la posizione o il formato esterno di una tabella

Imposta o modifica la descrizione della tabella

Imposta o modifica il partizionamento delle tabelle

Impostare o modificare il clustering delle tabelle

Modificare il tipo di un attributo di colonna

Aggiungi una connessione al lake di dati esterno

Modificare la codifica dei caratteri di un file di input

Conversione di tipo globale

Seleziona la modifica dell'estratto conto

Specifica della funzione definita dall'utente

Impostazione della severità della precisione decimale

Mappatura dei nomi di output

Mappatura dei nomi statici

Mappatura dei nomi dinamica

Specificare il database predefinito e il percorso di ricerca dello schema

Riscrittura nome output globale

Ottimizza e migliora le prestazioni del linguaggio SQL tradotto

Applicazione di più configurazioni YAML