CREATE FILE app/synonym INDEXESONLY 

dove:

app

La cartella dell'applicazione in cui si trova il sinonimo.

sinonimo

Il sinonimo per la tabella esistente.

• CREATE FILE crea sempre un indice sulla chiave principale.
• CREATE FILE con INDEXESONLY ricrea l'indice sulla chiave principale e crea tutti gli indici dichiarati nel file di accesso.

La seguente sintassi genera una unione esterna completa a seconda dei campi reali:

JOIN FULL_OUTER hfld1 [AND hfld2 ...] IN table1 [TAG tag1] TO {UNIQUE|MULTIPLE} cfld [AND cfld2 ...] IN table2 [TAG tag2] [AS joinname]
END

dove:

hfld1

Il nome di un campo nella tabella host, contenente valori condivisi con un campo nella tabella di riferimento incrociato. Questo campo si chiama campo host.

AND hfld2...

La frase che inizia con AND, si richiede quando si specificano più campi.

• Per adattatori relazionali che supportano multi-campi e unioni concatenate, è possibile specificare fino a 16 campi. Consultare la documentazione del proprio adattatore per informazioni specifiche sulle funzioni unione supportate.

IN table1

È il nome della tabella host.

TAG tag1

Un nome tag fino a 66 caratteri, (di solito il nome del file master), usato come identificatore univoco per campi e alias in tabelle host.

Il nome tag per la tabella host deve essere lo stesso in tutti i comandi JOIN di una struttura unita.

TO [UNIQUE|MULTIPLE] crfld1

Il nome di un campo nella tabella di riferimento incrociato, contenente valori che corrispondono a quelli di hfld1 (o di campi host concatenati). Questo campo si chiama campo di riferimento incrociato.

Nota: UNIQUE restituisce solo una istanza e, se non è presente una istanza corrispondente nella tabella di riferimento incrociato, si restituiscono valori nulli.

Usare il parametro MULTIPLE quando crfld1 potrebbe avere multiple istanze in comune con un valore in hfld1. Notare che ALL è un sinonimo per MULTIPLE e, omettendo questo parametro completamente, risulta in un sinonimo per UNIQUE.

AND crfld2...

Il nome di un campo nella tabella di riferimento incrociato con valori in comune con hfld2.

Nota: crfld2 potrebbe essere qualificato. Questo campo è solo disponibile per adattatori che supportano unioni multi-campi.

IN crfile

È il nome della tabella con riferimento incrociato.

TAG tag2

Un nome tag fino a 66 caratteri, (di solito il nome del file master), usato come identificatore univoco per campi e alias in tabelle di riferimento incrociato. In una struttura ad unione ricorsiva, se non si fornisce nessun nome tag, tutti i nomi dei campi e alias sono prefissati con i primi quattro caratteri del nome unione.

Il nome tag per la tabella host deve essere lo stesso in tutti i comandi JOIN di una struttura unita.

AS joinname

Un nome opzionale fino a otto caratteri da poter assegnare alla struttura unione. È necessario assegnare un nome univoco ad una struttura unione se:

• È consigliabile assicurarsi che un comando JOIN successivo non lo sovrascrivi.
• È consigliabile deselezionarlo in seguito.
• La struttura è ricorsiva.

Nota: Se non si assegna un nome alla struttura unione con la frase AS, il nome si presuppone sia vuoto. Una unione senza un nome sovrascrive una unione esistente senza un nome.

END

Richiesta quando il comando JOIN risulta più lungo di una riga. Termina il comando e deve essere su una riga da solo.

La seguente sintassi genera una unione esterna completa basata su DEFINE:

JOIN FULL_OUTER deffld WITH host_field ... 
     IN table1 [TAG tag1]
     TO [UNIQUE|MULTIPLE] 
     cr_field IN table2 [TAG tag2] [AS joinname]
END

dove:

deffld

Il nome del campo virtuale per il file host (il campo host). È possibile definire il campo virtuale nel file principale o con un comando DEFINE.

WITH host_field

Il nome di qualsiasi campo reale nel segmento host con cui di desidera associare il campo virtuale. Questa associazione si richiede per localizzare il campo virtuale.

La frase WITH si richiede, a meno che il parametro KEEPDEFINES non sia impostato su ON e deffld non sia stato definito prima di emettere il comando JOIN.

Per determinare quale segmento contiene il campo virtuale, usare il ?

IN table1

È il nome della tabella host.

TAG tag1

Un nome tag fino a 66 caratteri, (di solito il nome del file master), usato come identificatore univoco per campi e alias in tabelle host.

Il nome tag per la tabella host deve essere lo stesso in tutti i comandi JOIN di una struttura unita.

TO [UNIQUE|MULTIPLE] crfld1

Il nome di un campo reale nella tabella di riferimento incrociato, i quali valori corrispondono a quelli del campo virtuale. Questo deve essere un campo reale dichiarato nel file principale.

Nota: UNIQUE restituisce solo una istanza e, se non è presente una istanza corrispondente nella tabella di riferimento incrociato, si restituiscono valori nulli.

Usare il parametro MULTIPLE quando crfld1 potrebbe avere multiple istanze in comune con un valore in hfld1. Notare che ALL è un sinonimo per MULTIPLE e, omettendo questo parametro completamente, risulta in un sinonimo per UNIQUE.

IN crfile

È il nome della tabella con riferimento incrociato.

TAG tag2

Un nome tag fino a 66 caratteri, (di solito il nome del file master), usato come identificatore univoco per campi e alias in tabelle di riferimento incrociato. In una struttura ad unione ricorsiva, se non si fornisce nessun nome tag, tutti i nomi dei campi e alias sono prefissati con i primi quattro caratteri del nome unione.

Il nome tag per la tabella host deve essere lo stesso in tutti i comandi JOIN di una struttura unita.

AS joinname

Un nome opzionale fino a otto caratteri da poter assegnare alla struttura unione. È necessario assegnare un nome univoco ad una struttura unione se:

• È consigliabile assicurarsi che un comando JOIN successivo non lo sovrascrivi.
• È consigliabile deselezionarlo in seguito.
• La struttura è ricorsiva e non si specificano nomi tag.

Se non si assegna un nome alla struttura unita con la frase AS, il nome si presuppone sia vuoto. Una unione senza un nome sovrascrive una unione esistente senza un nome.

END

Richiesta quando il comando JOIN risulta più lungo di una riga. Termina il comando e deve essere su una riga da solo.

La seguente sintassi genera una unione condizionale esterna completa:

JOIN FULL_OUTER FILE table1 AT hfld1 [WITH hfld2] [TAG tag1]
     TO {UNIQUE|MULTIPLE} 
     FILE table2 AT crfld [TAG tag2] [AS joinname]
     [WHERE expression1;
     [WHERE expression2;
     ...]
END

dove:

table1

Master File host.

AT

Collega il segmento principale o host corretto al segmento secondario o di riferimento incrociato corretto. I valori campo usati come parametro AT non si usano per creare il collegamento. Si usano come riferimento segmento.

hfld1

Il nome campo nel file principale, il quale segmento si unirà alla tabella di riferimento incrociato. Il nome campo deve essere al segmento di livello inferiore nella propria origine dati di riferimento.

tag1

Nome del tag opzionale come qualificatore univoco per campi e alias nel file nella tabella host.

hfld2

Una colonna di tabella con cui associare una JOIN condizionale basata su DEFINE. Per una unione condizionale basata su DEFINE, l'impostazione KEEPDEFINES deve essere ON ed è necessario creare i campi virtuali prima di emettere il comando JOIN.

MULTIPLE

Specifica una relazione una-a-molte tra table1 e table2. Notare che ALL è un sinonimo per MULTIPLE

UNIQUE

Specifica una relazione una-a-molte tra table1 e table2. Notare che ONE è un sinonimo per UNIQUE.

Nota: L'unione in UNIQUE restituirà solo una istanza della tabella di riferimento incrociato e se questa istanza non corrisponde in base alla valutazione dell'espressione WHERE, si restituiscono valori nulli.

crfile

Master File di riferimento incrociato.

crfld

Il nome campo unione nel file principale di riferimento incrociato.

tag2

Nome del tag opzionale come qualificatore univoco per campi e alias nel file nella tabella di riferimento.

joinname

Il nome associato con la struttura unita.

expression1, expression2

Qualsiasi espressione accettabile in un comando DEFINE FILE. Tutti i campi usati nelle espressioni devono risidere su un solo percorso.

END

Il comando END si richiede per terminare il comando e deve essere su una riga da solo.

Le seguenti richieste generano due tabelle Microsoft SQL Server da unire e quindi emetteno una richiesta rispetto all'unione. Le tabelle sono generate usando il campione wf_retail, da poter creare usando il tutorial WebFOCUS - Retail Demo, nella console web del server.

La seguente richiesta genera la tabella WF_SALES. Il campo ID_PRODUCT sarà usato nel comando unione esterna completa. La tabella generata conterrà i valori ID_PRODUCT da 2150 a 4000:

TABLE FILE WF_RETAIL_LITE
SUM GROSS_PROFIT_US PRODUCT_CATEGORY PRODUCT_SUBCATEG
BY ID_PRODUCT
WHERE ID_PRODUCT FROM 2150 TO 4000
ON TABLE HOLD AS WF_SALES FORMAT SQLMSS
END

La seguente richiesta genera la tabella WF_PRODUCT. Il campo ID_PRODUCT sarà usato nel comando unione esterna completa. La tabella generata conterrà i valori ID_PRODUCT da 3000 a 5000:

TABLE FILE WF_RETAIL_LITE
SUM PRICE_DOLLARS PRODUCT_CATEGORY PRODUCT_SUBCATEG PRODUCT_NAME
BY ID_PRODUCT
WHERE ID_PRODUCT FROM 3000 TO 5000
ON TABLE HOLD AS WF_PRODUCT FORMAT SQLMSS
END

La seguente richiesta emette il comando JOIN e visualizza valori dalle tabelle unite:

SET TRACEUSER=ON
SET TRACESTAMP=OFF
SET TRACEOFF=ALL
SET TRACEON = STMTRACE//CLIENT
JOIN FULL_OUTER ID_PRODUCT IN WF_PRODUCT TAG T1 TO ALL ID_PRODUCT IN WF_SALES TAG T2
 
TABLE FILE WF_PRODUCT
PRINT T1.ID_PRODUCT AS 'Product ID' 
PRICE_DOLLARS AS Price
T2.ID_PRODUCT AS 'Sales ID' 
GROSS_PROFIT_US
BY T1.ID_PRODUCT NOPRINT
ON TABLE SET PAGE NOPAGE
END

La traccia mostra che l'unione esterna completa è stata ottimizzata (tradotta a SQL), quindi il Server SQL è in grado di elaborare l'unione:

SELECT   
T1."ID_PRODUCT",  
T1."PRICE_DOLLARS",  
T2."ID_PRODUCT",  
T2."GROSS_PROFIT_US"  
FROM   
( WF_PRODUCT T1  
FULL OUTER JOIN WF_SALES T2  
ON T2."ID_PRODUCT" = T1."ID_PRODUCT" )  
ORDER BY   
T1."ID_PRODUCT";  

L'emissione ha una riga per ogni valore ID_PRODUCT, presente in una delle tabelle. Le righe con valori ID_PRODUCT da 2150 a 2167 sono solo nella tabella WF_SALES, quindi le colonne da WF_PRODUCT visualizzano il simbolo NODATA. Le righe con i valori ID_PRODUCT sopra a 4000 sono solo nella tabella WF_PRODUCT, quindi le colonne da WF_SALES visualizzano il simbolo NODATA. Le righe con valori ID_PRODUCT da 2000 a 4000 sono in entrambe le tabelle, quindi tutte le colonne presentano valori, come illustrato nella seguente immagine.

I sinonimi con più elementi principali sono ora supportati come origine per una unione in un singolo segmento, in un sinonimo target.

Una unione da un sinonimo con più elementi principali è soggetta alle seguenti condizioni:

• Le unioni condizionali non sono supportate (JOIN WHERE).
• L'unione deve essere unica. Ovvero, le frasi TO ALL o TO MUTLIPLE non sono supportate.
• Il target dell'unione non può essere un sinonimo con più elementi.
• Il target di JOIN deve essere un solo segmento, o un sinonimo con un solo segmento, o un segmento in un sinonimo con più elementi, ma con un solo elemento principale.
• Tutti i campo in JOIN devono essere FROM/TO un solo segmento. È possibile usare nell'unione qualsiasi segmento singolo nel sinonimo di origine.

Il seguente file principale descrive una struttura con più elementi principali, basati su totorial WebFOCUS Retail. Le due fact table wf_retail_sales and wf_retail_shipments sono elementi principali della tabella dimensione wf_retail_product.

FILENAME=WF_RETAIL_MULTI_PARENT, $
  SEGMENT=WF_RETAIL_SHIPMENTS, CRFILE=WFRETAIL/FACTS/WF_RETAIL_SHIPMENTS, CRINCLUDE=ALL,
    DESCRIPTION='Shipments Fact', $
  SEGMENT=WF_RETAIL_SALES, PARENT=., CRFILE=WFRETAIL/FACTS/WF_RETAIL_SALES, CRINCLUDE=ALL,
    DESCRIPTION='Sales Fact', $
  SEGMENT=WF_RETAIL_PRODUCT, CRFILE=WFRETAIL/DIMENSIONS/WF_RETAIL_PRODUCT, CRINCLUDE=ALL,
    DESCRIPTION='Product Dimension', $
   PARENT=WF_RETAIL_SHIPMENTS, SEGTYPE=KU,
    JOIN_WHERE=WF_RETAIL_SHIPMENTS.ID_PRODUCT EQ WF_RETAIL_PRODUCT.ID_PRODUCT;, $
   PARENT=WF_RETAIL_SALES, SEGTYPE=KU,
    JOIN_WHERE=WF_RETAIL_SALES.ID_PRODUCT EQ WF_RETAIL_PRODUCT.ID_PRODUCT;, $

La seguente immagine mostra le unioni tra queste tabelle nell'Editor di Sinonimo della console di gestione dati (DMC).

La seguente richiesta unisce il segmento di prodotto alla tabella dimensione wf_retail_vendor, a seconda dell'ID fornitore ed emette una richiesta rispetto alla struttura unita:

JOIN ID_VENDOR IN WF_RETAIL_MULTI_PARENT TO ID_VENDOR IN WF_RETAIL_VENDOR AS J1
TABLE FILE WF_RETAIL_MULTI_PARENT
SUM COGS_US DAYSDELAYED
BY PRODUCT_CATEGORY
BY VENDOR_NAME
WHERE PRODUCT_CATEGORY LT 'S'
ON TABLE SET PAGE NOPAGE
END

L'emissione è:

Quando uno schema a stella contiene un segmento con fact aggregati e un segmento di livello inferiore, con i fact con i relativi dettagli di livello, una richiesta che esegue l'aggregazione su entrambi i livelli e li restituisce ordinati per livello superiore potrebbe riscontrare l'effetto moltiplicativo. Questo significa che i valori fact che sono già aggregati potrebbero essere riaggregati e, quindi, restituire valori motliplicati.

Quando l'adattatore rileva l'effetto moltiplicativo, si disattiva l'ottimizzazione, per gestire l'elaborazione della richiesta e per aggirare l'effetto moltiplicativo. Tuttavia, la prestazione risulta danneggiata quando non si ottimizza una richiesta.

Un nuovo processo di analisi di contesto è stato introdotto in questo release che rileva l'effetto moltiplicativo e genera comandi script SQL, che recuperano i valori corretti per ogni contesto di segmento. Questi script sono quindi inoltrati a RDBMS come subquery in una dichiarazione SQL ottimizzata.

Per attivare la funzione analisi di contesto, fare clic su Modifica Impostazioni Adattatore Comune sulla pagina Adattatori della console web. Quindi, selezionare Sì per il parametro FCA nella sezione Impostazioni Varie e fare clic su Salva, come illustrato nella seguente immagine.

Questa sezione fornisce descrizioni dettagliate di nuove funzioni per l'adattatore per DB2.

L'adattatore per C9 INC è stato introdotto in questo release ed è disponibile come adattatore denominato sulla console web nella cartella SQL.

Questo adattatore fornisce accesso di lettura a dati Salesforce, memorizzati in C9 e supporta funzioni temporali C9, generando campi nel file principale con proprietà temporali.

DEFINE DAILY_TREND/YYMD WITH ID TEMPORAL_PROPERTY 
TREND=DB_EXPR(INTERVAL '1' DAY); TITLE='Daily Trend', $ 
DEFINE WEEKLY_TREND/YYMD WITH ID TEMPORAL_PROPERTY 
TREND=DB_EXPR(INTERVAL '1' WEEK); TITLE='Weekly Trend', $ 
DEFINE MONTHLY_TREND/YYMD WITH ID TEMPORAL_PROPERTY 
TREND=DB_EXPR(INTERVAL '1' MONTH); TITLE='Monthly Trend', $ 
DEFINE QUARTERLY_TREND/YYMD WITH ID TEMPORAL_PROPERTY 
TREND=DB_EXPR(INTERVAL '1' QUARTER); TITLE='Quarterly Trend', $ 
DEFINE YEARLY_TREND/YYMD WITH ID TEMPORAL_PROPERTY 
TREND=DB_EXPR(INTERVAL '1' YEAR); TITLE='Yearly Trend', $ 

Questi metedati consentono all'adattatore di ottimizzare una condizione predicato TABLE FILE come una clausola trending temporale durante il reporting. Per esempio:

TABLE FILE repro_nfs/OPPORTUNITY 
SUM AMOUNT EXPECTEDREVENUE 
BY DAILY_TREND 
WHERE 
DAILY_TREND FROM '2014-09-01' 
TO '2014-09-08'
END 

Ottimizzato come:

TREND FROM DATE '2014-09-01' 
TO DATE '2014-09-08' BY INTERVAL '1' DAY 
SELECT CAST(TrendDate() AS DATE), 
SUM(T1."Amount"), 
SUM(T1."ExpectedRevenue") 
FROM ads.Opportunity T1 
GROUP BY 
CAST(TrendDate() AS DATE) 
ORDER BY 
CAST(TrendDate() AS DATE); 

TABLE FILE OPPORTUNITY WRITE SUM AMOUNT 
WHERE DAILY_TREND EQ '2014-01-01' 

Risultati nella seguente query SQL:

AS OF DATE '2014-01-01' SELECT SUM(T1."Amount") FROM 
ads.Opportunity T1. 

Nota: La condizione WHERE xxx_TREND IS MISSING sarà ottimizzata come clausola C9 AS OF 'ALL'.

Un prospetto risultante da una query TABLE, contenente BY e una verifica FROM-TO, su un campo TREND, mostrerà il progresso dei totali selezionati, nel periodo di tempo specificato dalla clausola FROM-TO, con intervalli temporali specificati nella definizione del campo TREND.

Questa sezione fornisce descrizioni dettagliate di nuove funzioni per l'adattatore per Greenplum.

Gli adattatori per Greenplum, Hyperstage (PG) e PostgreSQL supportano il mapping del tipo dati A256V usando la seguente impostazione:

ENGINE SQLengine SET CONVERSION LONGCHAR ALPHA n

L'impostazione influenza il mapping di tutti i campi nativi con un tipo dati di [VAR]CHAR(32767) o TEXT. Il valore di n va da 1 a 32767. Il valore predefinito è 256.

L'adattatore per Hive è stato introdotto in questo release ed è disponibile come adattatore denominato sulla console web nella cartella SQL.

Questa sezione fornisce descrizioni dettagliate di nuove funzioni per l'adattatore per Hyperstage. Inoltre, si descrivono i vari miglioramenti di memoria e prestazione per Hyperstage.

L'adattatore per Hyperstage usando PostgreSQL (PG) è stato introdotto in questo release ed è disponibile come adattatore denominato sulla console web nella cartella SQL.

SQL ENGINE SET COMMANDTIMEOUT [n] 

SQL SQLengine SET HINT hint_syntax