# Teradati

Teradata è disponibile come destinazione solo nei progetti di replica dei dati di Qlik Talend Cloud. La connessione utilizza l'API Teradata Parallel Transporter (TPT) per il caricamento dei dati e ODBC per le query sui metadati, le richieste DDL e le informazioni provenienti dalle tabelle degli errori di Teradata.

## Configura la connessione

Prima di creare un'attività di replica, creare e testare una connessione alla destinazione Teradata.

1. In Connessioni, fare clic su Crea connessione.
2. Selezionare il connettore di destinazione Teradata.
3. Immettere le proprietà di connessione descritte in [Proprietà di connessione Teradata](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/teradata-target.htm#ConnectionProperties).
4. Fai clic su Verifica connessione e risolvi eventuali errori segnalati.
5. Salvare la connessione.

## Proprietà della connessione Teradata

Configurare le seguenti proprietà per la connessione di destinazione Teradata:

Proprietà della connessione di destinazione Teradata

| Sezione | Proprietà | Descrizione |
| --- | --- | --- |
| Destinazione dati | Gateway dati (obbligatorio) | Selezionare il gateway dati in grado di raggiungere il server Teradata e in cui sono installati i componenti client Teradata necessari. |
| Proprietà di connessione | Server Teradata (obbligatorio) | Immettere il nome del server Teradata o l'indirizzo IP. Assicurarsi che il server sia raggiungibile dal gateway dati selezionato. |
| Proprietà dell'account | Utente (obbligatorio) | Immettere il nome utente del database Teradata. Questa è una credenziale del database, non la stringa dell'account. |
| Password (obbligatorio) | Inserire la password dell'utente del database del server Teradata. Questa è una credenziale del database, non la stringa dell'account. |  |
| Stringa account | Inserire la stringa dell'account che l'amministratore del database Teradata ha assegnato all'utente. Questo è l'account di accesso al server di database ed è distinto dalle credenziali Utente e Password. |  |
| Proprietà del database | Inserisci nome database manualmente | Selezionare questa opzione per inserire il nome del database. |
| Database predefinito (obbligatorio) | Immettere il database Teradata in cui vengono replicati i dati. Il database deve essere accessibile all'utente specificato. |  |
| Carica database | Fare clic per individuare i database disponibili per l'utente specificato. L'elenco dipende dalla corretta connettività e dalle autorizzazioni dell'utente per il database. |  |
| Proprietà di connessione aggiuntive | Proprietà ODBC | Immettere le proprietà di connessione ODBC aggiuntive come coppie Nome e Valore. Verificare i nomi e i valori delle proprietà con il proprio amministratore Teradata o ODBC. |

## Prerequisiti

Preparare l'ambiente Teradata e l'accesso richiesti dalla connessione prima di creare la connessione di destinazione.

* Assicurarsi che il server Teradata sia installato nella propria rete e raggiungibile dal computer che esegue il gateway dati selezionato.
* Installare e configurare il driver ODBC Teradata e i componenti client Teradata necessari sul gateway dati. Non dare per scontato che un driver installato su un altro computer sia disponibile per il gateway.
* Chiedere a un amministratore del database Teradata di creare o identificare un utente del database e di fornire la password dell'utente e la stringa dell'account, quando richiesto.

Se si sta adattando la funzionalità target Teradata al proprio ambiente, chiedere a un amministratore del database Teradata di verificare se i seguenti privilegi sono richiesti per la propria attività. Le autorizzazioni si applicano al database di destinazione, se non diversamente specificato; non sono necessariamente i permessi minimi per ogni attività di Qlik Talend Cloud:

* `GRANT SELECT ON <database>`
* `GRANT INSERT ON <database>`
* `GRANT DELETE ON <database>`
* `GRANT UPDATE ON <database>`
* `GRANT EXECUTE ON <database>`
* `GRANT EXECUTE FUNCTION ON <database>`
* `GRANT EXECUTE PROCEDURE ON <database>`
* `GRANT CREATE TABLE ON <database>`
* `GRANT DROP TABLE ON <database>`
* `GRANT CREATE VIEW ON <database>`
* `GRANT DROP VIEW ON <database>`
* `GRANT NONTEMPORAL ON <database>`
* `GRANT CHECKPOINT ON <database>`

L'utente del database potrebbe inoltre richiedere la seguente autorizzazione per l'elaborazione del flusso:

* `GRANT CREATE MACRO ON <database>`

## Fornire l'accesso al database Teradata

L'utente inserito nella proprietà User della connessione deve essere registrato come utente nel database Teradata. Un amministratore di database Teradata deve concedere l'accesso a questo stesso utente prima di configurare la connessione e il database di destinazione Teradata. Utilizzare le credenziali per questo utente registrato nelle proprietà User e Password della connessione.

Per le autorizzazioni richieste, consultare l'elenco delle autorizzazioni esistenti nei [prerequisiti](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/teradata-target.htm#Prerequisites).

## Modificare il file hosts

Per consentire al gateway dati selezionato di accedere al database Teradata, aggiungere il mapping di Teradata al file hosts nel computer del gateway dati.

1. Sul computer del gateway dati selezionato, aprire il file hosts di Windows o Linux. I percorsi predefiniti sono:

   * Windows: `~:\Windows\System32\drivers\etc\hosts`
   * Linux: `/etc/hosts`

2. Aggiungere la mappatura Teradata nel formato seguente. Includi il suffisso `cop1` dopo il nome del database:

   `<Teradata Database IP address/hostname> <Teradata Database name>cop1`

   Ad esempio: `123.123.123.1 teradatadbonecop1`

   Assicurarsi che il nome del database nel file hosts corrisponda alla proprietà di connessione Database predefinito.

3. Salvare le modifiche.

## Risolvere gli errori di connessione

Se il test di connessione non riesce, esaminare l'errore segnalato e verificare i seguenti elementi prima di testare nuovamente la connessione:

* **Gateway o rete:** Verificare che il gateway dati selezionato sia in esecuzione e possa raggiungere il server Teradata. Verificare il nome del server o l'indirizzo IP ed eventuali regole di rete tra il gateway e il server.
* **Driver o client:** Verificare che il driver ODBC Teradata e i componenti client necessari siano installati e configurati sul gateway selezionato. Un driver installato sul computer locale non viene utilizzato da un gateway remoto.
* **Credenziali o autorizzazioni:** Verificare con un DBA i valori con distinzione tra maiuscole e minuscole di Utente e Password, la Stringa account facoltativa e le autorizzazioni di database necessarie.
* **Rilevamento database:** Se Carica database non restituisce alcun database o restituisce un errore, verificare prima la connettività e poi confermare che l'utente sia in grado di rilevare e accedere ai database. È possibile immettere un database noto con Immetti nome database manualmente, se opportuno.
* **Proprietà ODBC:** verificare per ogni coppia Nome e Valore l'ortografia, i valori supportati ed eventuali conflitti con la configurazione del driver. Rimuovere una proprietà opzionale che causa l'esito negativo del test di connessione o chiedere a un amministratore ODBC di verificarla.

## Tipi di dati .

La tabella seguente descrive le mappature predefinite dai tipi di dati Qlik Talend Cloud ai tipi di dati Teradata.

Nota informatica

Teradata non supporta l'applicazione delle modifiche ai tipi di dati binari in modalità Batch optimized apply.

Mappature dei tipi di dati di destinazione Teradata

| Tipo di dati Qlik Talend Cloud | Tipo di dati Teradata |
| --- | --- |
| BOOLEAN | BYTEINT |
| BYTES | VARBYTE (dimensione). La dimensione massima è 640.000 byte. |
| DATE | DATE |
| TIME | TIME (precisione) |
| DATETIME | TIMESTAMP (precisione) |
| INT1 | BYTEINT |
| INT2 | SMALLINT |
| INT4 | INTEGER |
| INT8 | BIGINT |
| NUMERIC | Se la scala è compresa tra 0 e 37, NUMERIC (precisione, scala). Se la scala è pari o superiore a 38, VARCHAR (45). |
| REAL4 | FLOAT. FLOAT di Teradata è equivalente a REAL e DOUBLE PRECISION. |
| REAL8 | FLOAT |
| STRING | VARCHAR (dimensione), fino a 64.000 byte. Se il sottotipo è JSON, viene invece utilizzato JSON. |
| UINT1 | BYTEINT |
| UINT2 | SMALLINT |
| UINT4 | INTEGER |
| UINT8 | BIGINT |
| WSTRING | VARCHAR (dimensione), fino a 640.000 byte. Se il sottotipo è JSON, viene invece utilizzato JSON. |
| BLOB | VARBYTE(${MAX\_LOB\_SIZE}). MAX\_LOB\_SIZE è la dimensione massima del LOB specificata per l'elaborazione di LOB a dimensione limitata. |
| [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/teradata-target.htm)CLOB | VARCHAR(${MAX\_LOB\_SIZE}), utilizzando un set di caratteri Unicode senza distinzione tra maiuscole e minuscole. MAX\_LOB\_SIZE è la dimensione massima del LOB specificata per l'elaborazione di LOB a dimensione limitata. Se il sottotipo è JSON, viene invece utilizzato JSON. |
| NCLOB | VARCHAR(${MAX\_LOB\_SIZE}), utilizzando un set di caratteri senza distinzione tra maiuscole e minuscole. MAX\_LOB\_SIZE è la dimensione massima del LOB specificata per l'elaborazione di LOB a dimensione limitata. Se il sottotipo è JSON, viene invece utilizzato JSON. |

Nota informatica

**Limitazioni dei LOB:** Teradata non supporta tipi di dati LOB completi. La destinazione utilizza invece mapping LOB di dimensioni limitate. La dimensione totale di una riga Teradata non può superare i 64 KB, pertanto includere le dimensioni di tutte le colonne quando si imposta la dimensione massima del LOB.

Per le colonne CLOB e NCLOB, le lunghezze dei caratteri vengono moltiplicate per tre per impostazione predefinita per supportare NLS. Ciò può aumentare le dimensioni risultanti delle colonne e delle righe di Teradata.

Il tipo di dati PERIOD di Teradata non è supportato.

## Limiti e considerazioni

* Le modalità di replica disponibili sono Caricamento completo, Applica modifiche e Memorizza modifiche.
* Per le attività che utilizzano Applica modifiche o Memorizza modifiche, le operazioni DDL e l'evoluzione automatica dello schema non sono supportate. Questa limitazione non si applica a un'attività di solo caricamento completo.
* Per la modalità Caricamento, la tabella di destinazione deve essere vuota e non deve avere indici secondari. Selezionare Stream quando l'attività richiede un'elaborazione DML continua o query simultanee sulle tabelle.

## Informazioni correlate

* [Creazione di un progetto di replica](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Replicating/data-replication-task.htm)