COPYTABLE
Copia tutti i record presenti nella tabella sorgente nella tabella destinazione. I campi della tabella destinazione e della sorgente messi in corrispondenza sono definiti dagli attributi CAMPISORG e CAMPIDEST. Non è effettuato alcun filtro sul gruppo.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| DATABASE | Stringa | ||||
| STRUTTURASORG | Stringa | ||||
| TABELLASORG | Tabella | ||||
| STRUTTURADEST | Stringa | ||||
| TABELLADEST | Tabella | ||||
| NUMCAMPI | Intero | ||||
| CAMPISORG | Variabile | ||||
| CAMPIDEST | Variabile | ||||
| ASSEGNAAUTOINC | Intero | ||||
| TRONCADATI | Intero | ||||
| GRUPPO | Stringa | ||||
| GRUPPODEST | Stringa | ||||
| NOMETABELLASORG | Stringa | ||||
| NOMETABELLADEST | Stringa | ||||
| CLONESTAZIONE | Intero | ||||
| CLONESTAZIONEDEST | Intero | ||||
| CLONESTAZIONESORG | Numerico | ||||
| TABLOCK | Booleano | 29.1 | |||
| ERRORE | Intero |
STRUTTURASORG
Definisce la struttura della tabella sorgente in formato testuale. Se l'attributo non è specificato, è necessario specificare l'attributo TABELLASORG.
TABELLASORG
Definisce il nome della tabella sorgente se diversa da quella indicata nella struttura.
STRUTTURADEST
Definisce la struttura della tabella destinazione in formato testuale. Se l'attributo non è specificato, è necessario specificare l'attributo TABELLADEST.
TABELLADEST
Definisce il nome della tabella destinazione se diversa da quella indicata nella struttura.
NUMCAMPI
Indica il numero di campi da copiare durante il trasferimento e il numero di elementi da prendere in considerazione per i vettori indicati nelle specifiche CAMPISORG e CAMPIDEST.
CAMPISORG
Definisce l'elenco dei campi della tabella sorgente da valorizzare (vettore alfanumerico).
Il primo campo indicato viene copiato sul primo campo indicato nel vettore dell'attributo CAMPIDEST.
CAMPIDEST
Definisce l'elenco dei campi della tabella destinazione da valorizzare (vettore alfanumerico).
Il primo campo indicato viene valorizzato con il primo campo indicato dal vettore dell'attributo CAMPISORG.
ASSEGNAAUTOINC
Consente di assegnare gli eventuali campi auto-incremento della tabella di destinazione con i valori della tabella di origine dell'operazione di copia. Se la tabella destinazione non ho campi auto-incremento, il parametro non produce alcun effetto. Se il parametro non è indicato si assume il valore 0.
- 0 - vengono riassegnati i valori del campo della tabella sorgente, assegnato al campo autoincremento, sulla tabella di destinazione.
- 1 - vengono assegnati i valori correnti del campo della tabella sorgente, assegnato al campo autoincremento, sulla tabella di destinazione.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | vengono riassegnati i valori del campo della tabella sorgente, assegnato al campo autoincremento, sulla tabella di destinazione |
1 | vengono assegnati i valori correnti del campo della tabella sorgente, assegnato al campo autoincremento, sulla tabella di destinazione |
TRONCADATI
Consente di eseguire il troncamento dei valori stringa laddove sia presente un campo destinazione con dimensione inferiore alla lunghezza della stringa. Se il parametro non è indicato si assume il valore 0. In questo caso SQL Server genera un errore.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | vengono assegnati i valori del campo della tabella sorgente alla tabella di destinazione; un eventuale stringa con lunghezza superiore alla dimensione del campo determina un errore che annulla l'esecuzione della specifica |
1 | vengono assegnati i valori del campo della tabella sorgente alla tabella di destinazione; le stringhe eccedenti la dimensione della colonna destinazione vengono troncate |
GRUPPO
Definisce per il database il valore del campo speciale DBGruppo dei record da identificare nella tabella sorgente.
GRUPPODEST
Definisce per il database il valore del campo speciale DBGruppo dei record da identificare nella tabella destinazione.
NOMETABELLASORG
Definisce il nome della tabella sorgente se diversa da quella indicata nel dizionario.
NOMETABELLADEST
Definisce il nome della tabella destinazione se diversa da quella indicata nel dizionario.
CLONESTAZIONE
Indica se la tabella da utilizzare deve essere quella definita come Clone per Stazione
CLONESTAZIONEDEST
Indica se la tabella da utilizzare deve essere quella definita come Clone per Stazione
CLONESTAZIONESORG
Indica se la tabella sorgente da utilizzare deve essere quella definita come Clone per Stazione.
TABLOCK
Permette di indicare l'operazione che blocca l'intera tabella durante l'esecuzione.
- Il blocco è utile in particolari situazioni e va usato nei contesti in cui si è certi che non si fermi l'operatività dell'installazione.
Vantaggi:
- Dimensione del log ridotta al minimo
- Ottimizzazione della velocità (se siamo in un contesto di bassa concorrenza, come durante un aggiornamento di db).
Svantaggi:
- La tabella è bloccata durante l'intera esecuzione, in caso di concorrenza si possono verificare dei blocchi.
ERRORE
Consente al programma di intercettare e gestire l'errore restituito dalla funzione.
Utilizzare uno dei metodi GetLastError*() della classe BCContextInfo per ottenere le informazioni dell'errore.