Condividi tramite

Connettersi all'origine Teradata

  • Articolo

Si applica a: SQL Server SSIS Integration Runtime in Azure Data Factory

L'origine Teradata estrae i dati dai database Teradata usando:

  • Una tabella o una vista:
  • Risultati di un'istruzione SQL.

L'origine usa la gestione connessione Teradata per connettersi all'origine Teradata. Per altre informazioni, vedere Usare la gestione connessione Teradata.

Risolvere i problemi dell'origine Teradata

È possibile registrare le chiamate eseguite dall'origine Teradata all'API Teradata Parallel Transporter (TPT). A tale scopo abilitare la registrazione dei pacchetti e selezionare l'evento Diagnostic a livello di pacchetto.

È possibile registrare le chiamate ODBC (Open Database Connectivity) che l'origine Teradata esegue al driver ODBC Teradata abilitando la traccia di Gestione driver ODBC. Per altre informazioni, vedere Come generare una traccia ODBC con l'amministratore origine dati ODBC.

Parallelism

L'origine Teradata supporta il parallelismo, in cui i processi di esportazione possono accedere alla stessa tabella o a tabelle diverse nello stesso momento. La variabile di database MaxLoadTasks imposta il numero massimo di processi di esportazione eseguibili contemporaneamente. È possibile definire questo numero massimo usando la variabile MaxLoadTasks.

Proprietà personalizzate dell'origine Teradata

Le proprietà personalizzate dell'interfaccia Teradata sono elencate nella tabella seguente. Tutte le proprietà sono di lettura/scrittura.

Nome proprietà Tipo di dati Descrizione
AccessMode Integer (enumerazione) Modalità utilizzata per accedere al database. I valori possibili sono Table Name e SQL Command. Il valore predefinito è Table Name.
BlockSize Intero Dimensioni in byte del blocco usato per la restituzione di dati al client. Il valore predefinito è 1048576 (1 MB). Il valore minimo è 256 byte. Il valore massimo è 16775168 byte.
Questa proprietà si trova nel riquadro Editor avanzato.
BufferMaxSize Intero Dimensioni massime totali del buffer di dati restituito dalla funzione GetBuffer. Devono essere sufficienti per contenere almeno una riga di dati, che include l'intestazione di riga, la riga di dati vera e propria e la sequenza finale del buffer. Le dimensioni massime totali predefinite del buffer di dati sono pari a 16775552 byte.
Per altre informazioni, vedere Esportare dati da un database Teradata usando GetBuffer.
BufferMode Booleano Il valore predefinito è True. Il valore deve essere True se viene usata la funzionalità PutBuffer. Questa proprietà si trova nel riquadro Editor avanzato.
DataEncryption Booleano Il valore predefinito è False. Se il valore è True viene usata la crittografia di sicurezza completa.
DefaultCodePage Intero Tabella codici da usare quando l'origine dati non dispone di informazioni sulla tabella codici. Questa proprietà si trova nel riquadro Editor avanzato.
DetailedTracingLevel Integer (enumerazione) Selezionare una delle opzioni seguenti per l’analisi avanzata:
Non abilitato: nessuna registrazione avanzata.
Generale: viene registrata l’analisi generale delle attività specifiche del driver.
CLI: viene registrata l’analisi delle attività associate a CLIv2.
Metodo di notifica: viene registrata l’analisi delle attività associate alla funzionalità di notifica.
Common Library (Libreria comune): viene registrata la traccia delle attività della libreria opcommon.
Tutto: viene registrata tutta la traccia attività precedente.
Il file di log di traccia avanzato è definito nella proprietà DetailedTracingFile.
La proprietà DetailedTracingFile deve essere impostata se l'opzione non è Off. Questa proprietà si trova nel riquadro Editor avanzato.
DetailedTracingFile String Percorso del file di log che viene generato automaticamente quando DetailedTracingLevel non è Off. Questa proprietà si trova nel riquadro Editor avanzato.
DiscardLargeRow Booleano Il valore predefinito è False. Ignora le righe grandi (di dimensioni superiori a 64 kB) se il valore è True.
ExtendedStringColumnsAllocation Booleano Maximal Transfer Character Allocation Factor (Fattore di allocazione massimo trasferimento caratteri) viene usato se il valore è True.
Questo valore deve essere impostato su True se la proprietà Export Width Table ID del database Teradata è impostata su Maximal Defaults (Valori predefiniti massimi).
Il valore predefinito è False.
JobMaxRowSize Intero È possibile supportare la dimensione massima delle righe. Questo valore è necessario se il valore DiscardLargeRow è True.
Valori validi:
64 (valore predefinito): è possibile supportare lunghezze di riga a 2 byte.
1024: è possibile supportare lunghezze di riga a 4 byte.
MaxSessions Intero Numero massimo di sessioni registrate. Il valore deve essere maggiore di uno. Il valore predefinito è una sessione per ogni processore di modulo di accesso (AMP, Access Module Processor) disponibile.
MinSessions Intero Numero minimo di sessioni registrate. Il valore deve essere maggiore di uno. Il valore predefinito è una sessione per ogni AMP disponibile.
QueryBandSessInfo Varchar Espressione di banda di query basata sulla sessione e definita dall'utente in un formato connection-string. Questa proprietà viene usata per il monitoraggio e la governance del chargeback. Questa proprietà si trova nel riquadro Editor avanzato.
SpoolMode Varchar I valori validi sono:
Spool: usare il valore predefinito Spool.
NoSpool: non usare Spool. Questo valore è valido solo se il server di database (DBS) supporta NoSpool.
NoSpoolOnly: non usare Spool in alcun caso. Il processo verrà terminato con un errore se il server di database non supporta NoSpool.
SqlCommand String Comando SQL da eseguire quando AccessMode è impostata su SQL Command.
TableName String Nome della tabella contenente i dati da usare quando la proprietà AccessMode è impostata su Table Name.
TenacityHours Intero Numero di ore per il quale il driver TPT prova ad accedere quando è già in esecuzione il numero massimo di operazioni di caricamento/esportazione. Il valore predefinito è 4 ore. Questa proprietà si trova nel riquadro Editor avanzato.
TenacitySleep Intero Numero di minuti di attesa del driver TPT prima che venga eseguito un tentativo di accesso quando viene raggiunto il limite. Il limite è definito dalle proprietà MaxSessions e TenacityHours. Il valore predefinito è 6 minuti. Questa proprietà si trova nel riquadro Editor avanzato.
UnicodePassThrough Booleano Off (valore predefinito): disabilita il pass-through Unicode.
On: Abilitare il pass-through Unicode.

Configurare l'origine Teradata

È possibile configurare l'origine Teradata a livello di codice o tramite la finestra di progettazione SQL Server Integration Services (SSIS).

Il riquadro Editor origine Teradata è illustrato nella figura seguente. Per altre informazioni, vedere le sezioni seguenti dell'Editor origine Teradata:

Editor origine Teradata

Il riquadro Editor avanzato contiene le proprietà impostabili a livello di codice. Per aprire il riquadro:

  • Nella pagina Flusso di dati del progetto Integration Services fare clic con il pulsante destro del mouse sull'origine Teradata e selezionare Visualizza editor avanzato.

Per altre informazioni sulle proprietà impostabili nella finestra di dialogo Editor avanzato, vedere Proprietà personalizzate dell'origine Teradata.

Riquadro Gestione connessione

Usare il riquadro Gestione connessione Teradata per selezionare l'istanza della gestione connessione Teradata per l'origine. In questo riquadro è anche possibile selezionare una tabella o una vista dal database. Per aprire il riquadro:

  1. In SQL Server Data Tools aprire il pacchetto SSIS contenente l'origine Teradata.

  2. Nella scheda Flusso di dati fare doppio clic sull'origine Teradata.

  3. Nell'Editor origine Teradata selezionare la scheda Gestione connessione.

Opzioni

Connection manager

  • Selezionare una gestione connessione esistente nell'elenco o creare una nuova istanza di gestione connessione Teradata selezionando Nuovo.

New

  • Selezionare Nuovo. Viene visualizzato il riquadro Editor gestione connessione Teradata. Da questo riquadro è possibile creare una nuova gestione connessione.

Modalità di accesso ai dati

  • Selezionare un metodo per la selezione dei dati dall'origine. Le opzioni disponibili vengono visualizzate nella tabella seguente.

    Opzione Descrizione
    Nome tabella - Esportazione TPT Consente di recuperare dati da una tabella o da una vista nell'origine dati Teradata. Quando questa opzione è selezionata, selezionare una tabella o una vista disponibile nell'elenco per Nome tabella o vista.
    Comando SQL - Esportazione TPT Recuperare dati dall'origine dati Teradata usando una query SQL. Quando questa opzione è selezionata, immettere una query in uno dei modi seguenti:
    • Immettere il testo della query SQL nel campo Testo comando SQL .
    • Selezionare Sfoglia per caricare la query SQL da un file di testo.
    • Selezionare Analizza query per verificare la sintassi del testo della query.

Anteprima

  • Selezionare Anteprima per visualizzare un massimo di 200 righe dei dati estratti dalla tabella o dalla vista selezionata.

Riquadro Colonne

Usare il riquadro Colonne per eseguire il mapping di una colonna di output a ogni colonna esterna (di origine). Per aprire il riquadro:

  1. In SQL Server Data Tools aprire il pacchetto SSIS contenente l'origine Teradata.

  2. Nella scheda Flusso di dati fare doppio clic sull'origine Teradata.

  3. Nell'Editor origine Teradata selezionare la scheda Colonne.

Opzioni

Colonne esterne disponibili

Questa tabella elenca le colonne esterne disponibili che è possibile selezionare per aggiungerle all'elenco Colonne esterne. È possibile elencare le colonne nell'ordine scelto. Non è possibile usare questa tabella per l'aggiunta o l'eliminazione di colonne.

  • Per scegliere tutte le colonne selezionare la casella di controllo Seleziona tutto.

Colonne esterne

Le colonne (di origine) esterne selezionate sono elencate in ordine. Per modificare l'ordine, cancellare prima l'elenco Colonne esterne disponibili, quindi selezionare una o più colonne in un ordine diverso.

Colonna di output

Anche se il nome della colonna (di origine) esterna selezionata è il nome di output predefinito, è possibile immettere qualsiasi nome univoco.

Nota

Se sono presenti colonne contenenti tipi di dati non supportati viene visualizzato un avviso con i tipi di dati non supportati e le colonne corrispondenti vengono rimosse dalle colonne di mapping.

Riquadro Output degli errori

Usare il riquadro Output degli errori per selezionare le opzioni di gestione degli errori. Per aprire il riquadro:

  1. In SQL Server Data Tools aprire il pacchetto SSIS contenente l'origine Teradata.

  2. Nella scheda Flusso di dati fare doppio clic sull'origine Teradata.

  3. Nell'Editor origine Teradata selezionare la scheda Output degli errori.

Opzioni

Comportamento in caso di errore

  • Selezionare il modo in cui l'origine Teradata deve gestire gli errori in un flusso:
    • Ignorare l'errore
    • Reindirizzare la riga
    • Interrompere il componente

Argomenti correlati: vedere Gestione degli errori nei dati.

Troncamento

  • Selezionare il modo in cui l'origine Teradata deve gestire il troncamento in un flusso:
    • Ignorare l'errore
    • Reindirizzare la riga
    • Interrompere il componente

Passaggi successivi