Destinazione Teradata

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

La destinazione Teradata carica i dati in blocco in Teradata Database.

La destinazione usa il gestore connessioni Teradata per connettersi a un'origine dati. Per altre informazioni, vedere Gestione connessione Teradata.

Opzioni di caricamento

La destinazione Teradata supporta due modalità di caricamento dei dati:

  • TPT Stream: questa modalità usa l'operatore Streaming dell'API TPT (protocollo Teradata TPump).

  • TPT Load (caricamento bulk rapido): questa modalità usa l'operatore Caricamento dell'API TPT (protocollo Teradata FastLoad) per il caricamento bulk rapido.

La modalità di caricamento rapido presenta le restrizioni seguenti:

  • Il limite di sessioni per il database Teradata è determinato dal fattore tra quelli sottostanti che viene rilevato per primo:

    • Limiti della sessione impostati tramite il comando SESSIONS
    • Limite di una sola sessione per AMP del database Teradata
    • Limite della piattaforma per il numero massimo di sessioni per applicazione: definito dalla variabile MaxSess nel file software dell'interfaccia del processore di comunicazioni (COP), CLISPB.DAT. È possibile usare il comando TDP SET MAXSESSIONS per specificare un limite di piattaforma. Il limite predefinito è uguale al valore MAXSESS per il server.

  • Gli indici di join non sono supportati.

  • Le chiavi esterne nelle tabelle di destinazione non sono supportate.

  • Le tabelle di destinazione definite con un indice secondario non sono supportate.

Per ulteriori informazioni sulle restrizioni di caricamento rapido di Teradata, vedere il riferimento per il caricamento rapido di Teradata.

È possibile impostare la modalità nell'Editor di destinazione Teradata (pagina Gestione connessioni).

Gestione degli errori

Gli errori restituiti durante il processo di caricamento vengono scritti in tabelle degli errori temporanee, che vengono bloccate durante il processo di caricamento. La proprietà Numero massimo di errori (MaxErrors) in Editor avanzato imposta il numero massimo di errori che possono essere scritti in queste tabelle.

Se Numero massimo di errori è maggiore di zero vengono generate tabelle di errore con nomi univoci e viene visualizzato un messaggio informativo nel log del pacchetto. Gli errori sono recuperabili tramite l'output standard degli errori del componente SSIS.

Le tabelle temporanee vengono eliminate al termine del processo di caricamento. Se le tabelle temporanee non possono essere lette dalla destinazione Teradata, non vengono eliminate a meno che non sia selezionata la proprietà Elimina sempre la tabella errori. Se il processo di caricamento viene arrestato prima del completamento, potrebbe essere necessario eliminare manualmente queste tabelle. Le tabelle si trovano nello stesso database della tabella di destinazione.

Quando viene raggiunto il Numero massimo di errori lo stato della tabella di destinazione dipende dalla modalità usata.

  • In modalità di caricamento rapido la tabella di destinazione non può essere usata. Per eseguire nuovamente, è necessario troncare oppure eliminare e ricreare la tabella di destinazione. Il rollback non è supportato.
  • In modalità operatore TPT Steam, la destinazione Teradata viene elaborata tramite il meccanismo delle righe bufferizzate. Se il processo si interrompe, tutte le modifiche completate (i buffer inviati) al momento dell'errore sono permanenti nella o nelle tabelle di destinazione. Non esiste il concetto di rollback. Le tabelle degli errori verranno rimosse.

La destinazione Teradata dispone di un output di errore. Per ulteriori informazioni, vedere Editor di destinazione Teradata (pagina Output errori).

Parallelismo

Il parallelismo è limitato in modalità di caricamento rapido e più processi di caricamento rapido indipendenti non possono accedere contemporaneamente alla stessa tabella. Il numero di processi di caricamento rapido simultanei è limitato anche dalla variabile di database MaxLoadTasks.

Non esiste alcuna restrizione del parallelismo in modalità Streaming TPT. È possibile eseguire più destinazioni Teradata in parallelo sulla stessa tabella, anche se ciò può ridurre le prestazioni di ciascuna destinazione Teradata. Per altre informazioni, vedere la documentazione di Teradata.

Risoluzione dei problemi relativi alla destinazione Teradata

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

È possibile registrare nel log le chiamate ODBC effettuate dall'origine dati Teradata al driver ODBC Teradata abilitando la traccia del gestore driver ODBC. Per ulteriori informazioni, consultare la documentazione Microsoft su Come generare una traccia ODBC con l'Amministratore origine dati ODBC.

Proprietà personalizzate della destinazione Teradata

La tabella seguente descrive le proprietà personalizzate della destinazione Teradata. Tutte le proprietà sono leggibili e scrivibili.

Nome della proprietà Tipo di dati Descrizione
AlwaysDropErrorTable Booleano L'impostazione predefinita è False. Se è True elimina tutte le tabelle di errore, anche in caso di errore di lettura della destinazione Teradata.
ArraySupport Booleano L'impostazione predefinita è True. Se è True i gruppi DML usano ArraySupport. Applicabile solo per Streaming TPT. Questa proprietà si trova in Editor avanzato.
Buffer Intero Numero dei buffer di richiesta da aumentare. Il valore può essere impostato da 2 a 64. Applicabile solo per Streaming TPT. Questa proprietà si trova in Editor avanzato.
BufferMode Booleano L'impostazione predefinita è True. Deve essere True se viene usata la funzionalità PutBuffer. Questa proprietà si trova in Editor avanzato.
Dimensione del buffer Intero Dimensioni del buffer di output (in KB) usato per l'invio di pacchetti di carico. Il valore predefinito è 1024. Applicabile solo a TPT Load. Questa proprietà si trova in Editor avanzato.
DataEncryption Booleano L'impostazione predefinita è False. Se è 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.
Nota: questa proprietà si trova in Editor avanzato.
DetailedTracingLevel Integer (Enumerazione) Selezionare una delle opzioni seguenti per l’analisi avanzata:
Disattivato: Nessuna registrazione avanzata.
Generale: viene registrata l’analisi generale delle attività specifiche del driver.
CLI: viene registrato il tracciamento delle attività relative 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.
Tutte: Viene registrato il tracciamento di tutte le attività sopra indicate.
Il file di log di traccia avanzato è definito nella proprietà DetailedTracingFile.
Se l'opzione non è Off la proprietà DetailedTracingFile deve essere impostata.
Questa proprietà si trova in Editor avanzato.
File di traccia dettagliata String Percorso del file di log che viene generato automaticamente quando DetailedTracingLevel non è Off. Questa proprietà si trova in Editor avanzato.
DiscardLargeRow Booleano L'impostazione predefinita è False. Se è True, rimuove le righe di grandi dimensioni (maggiori di 64K)
ErrorTableName String Nome della tabella degli errori. Il valore predefinito è il nome della tabella di destinazione
Allocazione estesa delle colonne stringa Booleano Fattore massimo di allocazione dei caratteri di trasferimento viene utilizzato se True.
Questo valore deve essere impostato su True se la proprietà Export Width Table ID (ID tabella larghezza esportazione) del database Teradata è impostata su Maximal Defaults (Valori predefiniti massimi).
L'impostazione predefinita è False.
FastLoad Booleano Se è True viene usato il caricamento rapido. Il valore predefinito è false. Questo può anche essere impostato nell'Editor di destinazione Teradata (pagina Gestione connessioni).
MaxErrors Intero Numero di errori che possono verificarsi prima dell'arresto del flusso di dati. Il valore predefinito è 0, ovvero nessun limite per il numero di errori.
Se è selezionato Reindirizza flusso nella pagina Gestione degli errori. Prima del raggiungimento del limite per il numero di errori, vengono restituiti tutti gli errori nell'output degli errori. Per ulteriori informazioni, vedere Editor di destinazione Teradata (pagina Output errori).
MaxSessions Intero Numero massimo di sessioni registrate. Il valore deve essere maggiore di uno. Il valore predefinito è una sessione per ogni AMP disponibile.
MinSessions Intero Numero minimo di sessioni registrate. Il valore deve essere maggiore di uno. Il valore predefinito è una sessione per ogni AMP disponibile.
Pacchetto Intero Numero di istruzioni da comprimere in una richiesta a più istruzioni. Il valore predefinito è 20, il valore massimo consentito è 2400. Applicabile solo per Streaming TPT. Questa proprietà si trova in Editor avanzato.
PackMaximum Booleano Se è True determina in modo dinamico il fattore di compressione massimo per il processo Streaming corrente. Applicabile solo per Streaming TPT. Questa proprietà si trova in Editor avanzato.
QueryBandSessInfo Varchar Espressione di banda di query basata su sessione definita dall'utente per abilitare il monitoraggio e la governance del chargeback. Questa proprietà deve essere in formato connection-string. Questa proprietà si trova in Editor avanzato.
ReplicationOveride Integer (enumerazione) Opzioni:
Impostazione predefinita: nessuna istruzione SET SESSION OVERRIDE REPLICATION viene inviata al database. Vengono usate le impostazioni predefinite del database.
Attivo: i controlli standard del servizio di replica vengono ignorati.
Disattivato: vengono usati i normali controlli del servizio di replica.
Questa proprietà è applicabile solo per Streaming TPT.
Questa proprietà si trova in Editor avanzato.
Solido Booleano Se è True viene usata la logica di riavvio Robust per le operazioni di ripristino e riavvio. Questa proprietà è applicabile solo per Streaming TPT. Questa proprietà si trova in Editor avanzato.
TableName String Nome della tabella con i dati in uso.
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 in Editor avanzato.
TenacitySleep Intero 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 in Editor avanzato.
UnicodePassThrough Booleano Disattivato (impostazione predefinita): disabilita il pass-through Unicode.
Attivato: abilita il pass-through Unicode.

Configurazione della destinazione Teradata

È possibile configurare la destinazione Teradata a livello di codice o tramite Progettazione SSIS.

L'editor di destinazione Teradata è illustrato nell'immagine seguente. Contiene la pagina Gestione connessione, la pagina Mapping e la pagina Output degli errori.

Per ulteriori informazioni, vedere uno degli argomenti seguenti:

editor di destinazione

La finestra di dialogo Editor avanzato contiene le proprietà che è possibile impostare a livello di codice. Per aprire la finestra di dialogo Editor avanzato :

  • Nella schermata Flusso di dati del progetto Integration Services fare clic con il pulsante destro del mouse sulla destinazione Teradata e selezionare Visualizza editor avanzato.

Per altre informazioni sulle proprietà impostabili nella finestra di dialogo Editor avanzato, vedere Proprietà personalizzate della destinazione Teradata.

Editor della destinazione Teradata (pagina Gestione connessione)

Usare la pagina Gestione connessione della finestra di dialogo Editor destinazione Teradata per selezionare la gestione connessione Teradata per la destinazione. Tramite questa pagina è inoltre possibile selezionare una tabella o una vista del database.

Per aprire la pagina di Gestione connessioni dell'Editor di destinazione Teradata

  • In SQL Server Data Tools aprire il pacchetto di SQL Server Integration Services (SSIS) con la destinazione Teradata.

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

  • Nell'Editor destinazione Teradata, fare clic su Gestione connessioni.

Opzioni

Gestione connessione

Consente di selezionare una gestione connessione esistente nell'elenco o di creare una nuova gestione connessione Teradata facendo clic su Nuovo.

New

Fai clic su Nuovo. Verrà visualizzata la finestra di dialogo Editor gestione connessione Teradata, in cui è possibile creare una nuova gestione connessione.

Modalità di accesso ai dati

Consente di selezionare il metodo per la selezione dei dati dall'origine. Le opzioni disponibili vengono visualizzate nella tabella seguente.

Opzione Descrizione
Nome della tabella - TPT Stream Modalità incrementale che utilizza l'operatore TPT Stream.
Nome della tabella o della vista: selezionare una tabella o vista esistente dall'elenco. Questo elenco visualizza solo le prime 1000 tabelle. È possibile digitare il prefisso del nome della tabella oppure usare qualsiasi parte del nome con il carattere jolly (*) per elencare la tabella o le tabelle che si desidera usare.
Nome tabella – Caricamento TPL Modalità di caricamento veloce (percorso diretto) che usa l'operatore di caricamento API TPT (Teradata FastLoad Protocol) e richiede che la tabella di destinazione sia vuota.
Nome tabella o vista: selezionare una tabella o vista esistente nell'elenco. Questo elenco visualizza solo le prime 1000 tabelle. È possibile digitare il prefisso del nome della tabella oppure usare una parte qualsiasi del nome con il carattere wildcard (*) per elencare la tabella o le tabelle da utilizzare.

Crittografia dei dati: casella di controllo per abilitare la crittografia dei dati. Per impostazione predefinita l'opzione non è selezionata.

Elimina sempre la tabella errori: casella di controllo per eliminare le tabelle degli errori in tutte le istanze.

Tabella errori: nome della tabella in cui vengono scritti gli errori.

Numero minimo di sessioni: numero minimo di sessioni registrate. Il valore predefinito è una sessione per ogni AMP disponibile. Il valore deve essere maggiore di 1.

Numero massimo di sessioni: numero massimo di sessioni registrate. Il valore predefinito è una sessione per ogni AMP disponibile. Il valore deve essere maggiore di 1.

Numero massimo di errori: numero massimo di errori che possono essere restituiti prima che il flusso di dati venga interrotto o reindirizzato.

Editor della destinazione Teradata (pagina delle mappature)

Utilizzare la pagina Mappings della finestra di dialogo Editor di destinazione Teradata per associare le colonne di input alle colonne di destinazione.

Per aprire la pagina Mappature dell'Editor di destinazione Teradata

  • In SQL Server Data Tools aprire il pacchetto di SQL Server Integration Services (SSIS) con la destinazione Teradata.

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

  • Nell'editor di destinazione di Teradata, fare clic su Mappature.

Opzioni

Colonne di input disponibili

Elenco delle colonne di input disponibili. Trascinare e rilasciare una colonna di input su una colonna di destinazione disponibile per mappare le colonne.

Colonne di destinazione disponibili

Elenco delle colonne di destinazione disponibili. Trascina e rilascia una colonna di destinazione su una colonna di input disponibile per associare le colonne.

Colonna di input

Consente di visualizzare le colonne di input selezionate dall'utente. È possibile rimuovere i mapping selezionando < ignora > per escludere colonne dall'output.

Colonna di destinazione

Visualizza tutte le colonne di destinazione disponibili, sia mappate che non mappate.

Nota

Le colonne con tipi di dati non supportati vengono eliminate dal mapping con un avviso.

Editor di destinazione Teradata (pagina di output degli errori)

Utilizzare la pagina Output errori della finestra di dialogo Editor di destinazione Teradata per selezionare le opzioni di gestione degli errori.

Per aprire la pagina Output errori della finestra di modifica della destinazione Teradata

  • In SQL Server Data Tools aprire il pacchetto di SQL Server Integration Services (SSIS) con la destinazione Teradata.

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

  • Nell'Editor destinazione Teradata, fare clic su Output degli errori.

Opzioni

Comportamento in caso di errore

Consente di selezionare il modo in cui la destinazione Teradata deve gestire gli errori in un flusso: ignorare l'errore, reindirizzare la riga o interrompere il componente.

Argomenti correlati: Gestione degli errori nei dati

Troncamento

Consente di selezionare il modo in cui la destinazione Teradata deve gestire il troncamento in un flusso: ignorare l'errore, reindirizzare la riga o interrompere il componente.

Passaggi successivi

  • Last updated on