SAP BusinessObjects platform Business Intelligence Manuale
Below you will find brief information for Business Intelligence BusinessObjects platform. This document provides comprehensive information about data access, covering aspects such as components of a connection, system architecture, specific data access features , and more. It allows users to connect to different data sources and access various data formats.
annuncio pubblicitario
Assistente Bot
Hai bisogno di aiuto? Il nostro chatbot ha già letto il manuale ed è pronto ad assisterti. Sentiti libero di fare qualsiasi domanda sul dispositivo, ma fornire dettagli renderà la conversazione più produttiva.
▼
Scroll to page 2
of
262
Manuale dell'accesso ai dati ■ SAP BusinessObjects Business Intelligence platform 4.1 2013-07-02 Copyright © 2013 SAP AG o una sua affiliata. Tutti i diritti riservati.Non è ammessa la riproduzione o la trasmissione del presente documento, né di alcuna delle sue parti, in qualsiasi formato o per qualsiasi fine senza l’esplicita autorizzazione di SAP AG. Le informazioni qui contenute sono soggette a modifica senza preavviso. Alcuni prodotti software commercializzati da SAP AG e dai suoi distributori contengono componenti software di proprietà di altri produttori di software. Le specifiche nazionali dei prodotti possono variare. Tali informazioni sono fornite da SAP AG e dalle sue affiliate (“Gruppo SAP”) solo a scopo informativo, senza alcun fine illustrativo o di garanzia di qualsiasi natura; il Gruppo SAP non si assume alcuna responsabilità per eventuali errori od omissioni presenti nelle informazioni. Le uniche garanzie applicabili ai prodotti e ai servizi del Gruppo SAP sono quelle espressamente menzionate nelle apposite clausole contrattuali eventualmente previste per i singoli prodotti o servizi. Nessuna parte del presente documento è da interpretarsi come garanzia aggiuntiva. SAP e gli altri prodotti e servizi SAP qui menzionati, nonché i relativi loghi, sono marchi o marchi registrati di SAP AG in Germania e in altri Paesi. Per ulteriori informazioni e comunicazioni sui marchi consultare http://www.sap.com/italy/about/company/legal/copyright/index.epx. 2013-07-02 Sommario 3 Capitolo 1 Cronologia delle versioni del documento..............................................................................13 Capitolo 2 Introduzione al manuale di accesso ai dati...........................................................................19 2.1 2.2 2.3 2.4 2.5 Informazioni sul manuale........................................................................................................19 Capitolo 3 Introduzione all'accesso ai dati.............................................................................................23 3.1 3.2 3.2.1 3.2.2 3.3 3.3.1 3.3.2 3.4 3.5 Informazioni su Connection Server.........................................................................................23 Capitolo 4 Informazioni sulle caratteristiche specifiche dell'accesso ai dati.........................................31 4.1 4.1.1 4.1.2 4.1.3 4.2 4.3 4.3.1 4.3.2 4.3.3 4.3.4 4.3.5 Supporto per sistemi operativi a 64 bit...................................................................................31 Destinatari.............................................................................................................................19 Novità....................................................................................................................................19 Attività principali.....................................................................................................................21 Convenzioni presenti in questo manuale.................................................................................21 Componenti di una connessione............................................................................................23 Architettura di sistema...........................................................................................................24 Driver di accesso ai dati.........................................................................................................24 File di configurazione per l'accesso ai dati..............................................................................25 Informazioni sul file di configurazione globale cs.cfg...............................................................26 Informazioni sui file di configurazione dei driver......................................................................26 Modalità di distribuzione.........................................................................................................28 Servizi di connessione............................................................................................................28 Supporto UNIX a 64 bit..........................................................................................................31 Supporto Microsoft Windows a 64 bit....................................................................................32 Installazione dei driver ODBC.................................................................................................33 Supporto Single Sign On........................................................................................................33 Stored procedure...................................................................................................................35 Funzionalità di database supportate........................................................................................35 Stored procedure Oracle........................................................................................................36 Creazione di un cursore all'interno di un pacchetto.................................................................36 Creazione di una stored procedure Oracle.............................................................................37 Stored procedure SAP HANA................................................................................................37 2013-07-02 Sommario 4 4.3.6 4.4 4.4.1 4.5 4.5.1 4.5.2 4.5.3 4.6 4.6.1 4.6.2 4.7 Stored procedure Teradata....................................................................................................38 Capitolo 5 Creazione di una connessione..............................................................................................45 5.1 5.2 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 5.2.8 5.2.9 5.2.10 5.3 5.3.1 5.3.2 5.3.3 5.3.4 5.3.5 5.4 5.4.1 5.4.2 5.4.3 5.5 5.5.1 5.5.2 Requisiti di connessione.........................................................................................................45 Pool di connessioni................................................................................................................38 Informazioni sulle connessioni del pool...................................................................................39 Bilanciamento del carico:........................................................................................................39 Ricerca del server migliore.....................................................................................................40 Logica del bilanciamento del carico........................................................................................41 Compatibilità con le versioni precedenti.................................................................................41 Allocazione di memoria...........................................................................................................42 Abilitazione di HOARD...........................................................................................................42 Disabilitazione di HOARD.......................................................................................................42 Attività nella workstation CA Wily Introscope.........................................................................43 Controllo della configurazione delle connessioni.....................................................................45 Visualizzazione della guida relativa allo strumento cscheck ....................................................46 Esecuzione dello strumento cscheck......................................................................................47 Strumento di controllo - Panoramica della funzione.................................................................47 Strumento cscheck - list.........................................................................................................48 Strumento cscheck - driverssearch........................................................................................49 Strumento cscheck - find.......................................................................................................50 Strumento cscheck - middleware...........................................................................................52 Strumento cscheck - accessdriver.........................................................................................53 Strumento cscheck - connectivity...........................................................................................54 Strumento cscheck - ping ......................................................................................................55 Creazione di connessioni JDBC ............................................................................................57 Creazione di una connessione JDBC con il file SBO..............................................................58 Struttura file di esempio SBO JDBC......................................................................................59 Creazione di una connessione JDBC con Extensions.............................................................59 Riferimento per la posizione del file JAR................................................................................60 Creazione di una connessione JDBC generica.......................................................................63 Creazione di connessioni JavaBean.......................................................................................64 Creazione di una connessione JavaBean................................................................................65 Struttura file di esempio SBO JavaBean ...............................................................................65 Creazione di una connessione JavaBean con Extensions.......................................................66 Creazione di connessioni ODBC............................................................................................66 Creazione di una connessione ODBC generica......................................................................67 Creazione di una connessione ODBC3 generica....................................................................68 2013-07-02 Sommario 5 Capitolo 6 Riferimento per i driver di accesso ai dati.............................................................................71 6.1 6.2 6.2.1 6.2.2 6.2.3 6.2.4 6.3 6.3.1 6.3.2 6.3.3 6.3.4 6.3.5 6.3.6 6.3.7 6.3.8 6.3.9 6.3.10 6.3.11 6.3.12 6.3.13 6.3.14 6.4 6.4.1 6.4.2 6.4.3 6.4.4 6.5 6.5.1 6.5.2 6.5.3 6.5.4 6.5.5 6.5.6 6.5.7 6.5.8 6.5.9 6.5.10 6.5.11 6.5.12 Driver di accesso ai dati.........................................................................................................71 CSV OpenDriver....................................................................................................................71 Funzionalità di CSV OpenDriver.............................................................................................72 CSV OpenDriver - Mappatura di tabelle.................................................................................72 Percorso del file CSV.............................................................................................................74 Rilevamento dello schema CSV.............................................................................................74 Driver OData..........................................................................................................................76 Funzionalità del driver OData..................................................................................................77 Posizione del servizio OData..................................................................................................77 Esempio di servizio OData.....................................................................................................78 Driver OData - Mappatura di spazio dei nomi, proprietario e qualificatore...............................79 Driver OData - Mappatura di tabelle.......................................................................................80 Driver OData - Mappatura di colonne.....................................................................................81 Driver OData - Mappatura di chiavi.........................................................................................81 Driver OData - Mappatura degli elementi Documentation.......................................................83 Driver OData - Mappatura di entità di tipi derivati...................................................................83 Monitoraggio delle prestazioni del driver OData.....................................................................84 Driver OData - Comportamenti non semplici e restrizioni.......................................................86 Driver OData - Configurazione della dimensione massima delle colonne................................87 Autenticazione di origini OData..............................................................................................88 Analisi dell'attività del driver OData........................................................................................88 Driver SAP ERP.....................................................................................................................89 Funzionalità dei driver SAP ERP.............................................................................................89 Driver SAP ERP - Accesso a InfoSet e query SAP.................................................................90 Driver SAP ERP - Accesso alle funzioni ABAP.......................................................................92 Restrizioni dei driver SAP ERP...............................................................................................95 Driver XML ...........................................................................................................................95 Funzionalità del driver XML.....................................................................................................96 Posizione dei file XML............................................................................................................96 Esempio di documento e schema XML...................................................................................97 Driver XML - Mappatura di più file..........................................................................................99 Driver XML - Mappatura di tabelle..........................................................................................99 Driver XML - Mappatura di colonne......................................................................................100 Driver XML - Mappatura di chiavi primarie ed esterne..........................................................102 Driver XML - Mappatura di elementi misti.............................................................................103 Driver XML - Mappatura di elementi ricorsivi........................................................................104 Driver XML - Mappatura di any e anyAttribute......................................................................104 Driver XML - Mappatura di anyType e simpleType................................................................106 Driver XML - Configurazione della dimensione massima delle colonne.................................107 2013-07-02 Sommario 6 6.6 6.6.1 6.6.2 6.6.3 6.6.4 6.6.5 6.7 Driver di servizio Web..........................................................................................................107 Capitolo 7 Riferimenti alle connessioni................................................................................................115 7.1 7.1.1 7.2 7.3 7.3.1 7.3.2 7.4 7.5 7.6 7.7 7.8 7.9 7.9.1 Connessioni HIVE................................................................................................................115 7.9.2 7.10 7.10.1 7.10.2 7.10.3 7.10.4 7.10.5 7.10.6 7.10.7 7.11 7.12 7.12.1 7.13 7.13.1 7.14 Per fare in modo che le connessioni salesforce.com funzionino con Universe Design Tool...122 Funzionalità del driver di servizio Web..................................................................................108 Posizione del servizio Web...................................................................................................108 Esempio di definizione di servizio Web.................................................................................109 Regole di mappatura per i servizi Web.................................................................................110 Driver di servizio Web - Configurazione della dimensione massima delle colonne.................113 Disco locale utilizzato come cache per le operazioni di ordinamento.....................................114 Creazione di una connessione ad Amazon EMR HIVE..........................................................116 Connessioni IBM DB2.........................................................................................................117 Connessioni IBM Informix....................................................................................................117 Problema con i valori data in caso di fusi orari diversi...........................................................117 Errore di connessione in caso di mancato supporto della modalità transazione.....................118 Connessioni MS Analysis Services......................................................................................118 Connessioni Oracle..............................................................................................................119 Connessioni Oracle EBS......................................................................................................119 Connessioni Oracle Essbase................................................................................................120 Connessioni Oracle RAC.....................................................................................................120 Connessioni salesforce.com................................................................................................120 Procedura per consentire il funzionamento delle connessioni salesforce.com in Information Design Tool......................................................................................................................................121 Connessioni SAP HANA......................................................................................................122 Creazione di una connessione SAP HANA...........................................................................123 Modifica di una connessione SAP HANA.............................................................................124 Prima di configurare il Single Sign On per le connessioni SAP HANA...................................125 Configurazione del Single Sign On per Information Design Tool...........................................125 Configurazione del Single Sign On per Web Intelligence......................................................127 Configurazione del Single Sign On per Web Intelligence Rich Client.....................................127 Configurazione di Java Virtual Machine per la strumentazione..............................................128 Connessioni SAP MaxDB....................................................................................................128 Connessioni SAP NetWeaver BW.......................................................................................129 Requisiti per la connessione di Data Federator a SAP NetWeaver BW................................129 Connessioni SAS.................................................................................................................130 Installazione di driver per connessioni SAS..........................................................................130 Connessioni Teradata..........................................................................................................130 2013-07-02 Sommario 7 Capitolo 8 Creazione di una connessione al server delle query di Data Federator XI 3.0....................133 8.1 8.2 Informazioni sulle connessioni al server delle query di Data Federator XI 3.0........................133 8.3 8.3.1 8.3.2 8.4 Configurazione delle connessioni ODBC Data Federator.....................................................134 8.4.1 Configurazione del middleware ODBC Data Federator per una connessione a Web Intelligence Rich Client...........................................................................................................................137 8.4.2 Configurazione di Connection Server per una connessione Web Intelligence Rich Client a Data Federator.............................................................................................................................137 8.4.3 8.4.4 Impostazione della chiave di registro di Windows RichClient ...............................................138 Capitolo 9 Configurazione dei parametri globali di accesso ai dati.....................................................141 9.1 9.2 9.3 9.4 9.5 9.5.1 9.5.2 9.5.3 9.5.4 9.5.5 9.5.6 9.5.7 9.5.8 9.5.9 9.5.10 9.5.11 9.5.12 9.6 9.7 9.8 9.8.1 9.9 Informazioni sui parametri globali..........................................................................................141 Configurazione della procedura guidata di connessione per una connessione JDBC o ODBC a Data Federator.....................................................................................................................134 Configurazione del middleware ODBC Data Federator ........................................................135 Configurazione di Connection Server per una connessione ODBC a Data Federator...........135 Configurazione delle connessioni Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator.....................................................................................................................136 Configurazione di Connection Server per le connessioni a Data Federator di Web Intelligence Rich Client o di Universe Design Tool..................................................................................138 Informazioni sul file di configurazione cs.cfg.........................................................................141 Informazioni sul file di configurazione OlapClient.cfg.............................................................142 Visualizzazione e modifica del file cs.cfg...............................................................................142 Configurazione dei parametri delle impostazioni globali........................................................143 Charset List Extension.........................................................................................................143 Config File Extension............................................................................................................144 Description Extension..........................................................................................................144 Ignore Driver Load Failure....................................................................................................144 Load Drivers On Startup......................................................................................................145 Max Pool Time.....................................................................................................................146 Setup File Extension.............................................................................................................146 SQL External Extension........................................................................................................147 SQL Parameter Extension....................................................................................................147 Strategies Extension............................................................................................................148 Validate Configuration Files..................................................................................................148 Validate XML Streams.........................................................................................................148 Impostazione della modalità di distribuzione..........................................................................149 Configurazione della modalità di distribuzione.......................................................................150 Configurazione dei driver da caricare....................................................................................150 Impostazione di una connettività per computer.....................................................................151 Configurazione dei protocolli di accesso CORBA.................................................................151 2013-07-02 Sommario 8 9.10 9.10.1 9.10.2 9.10.3 9.10.4 9.10.5 9.11 9.11.1 Attivazione di registri e analisi di Connection Server e dei relativi driver...............................152 Capitolo 10 Configurazione dei parametri dei driver di accesso ai dati.................................................161 10.1 10.1.1 10.1.2 10.1.3 10.1.4 10.1.5 10.1.6 10.2 10.2.1 Configurazione dei parametri del driver................................................................................161 Capitolo 11 Riferimento ai parametri SBO.............................................................................................173 11.1 11.2 11.3 11.3.1 11.3.2 11.3.3 11.3.4 11.3.5 11.3.6 11.3.7 11.3.8 11.3.9 11.3.10 11.3.11 11.3.12 11.3.13 11.3.14 11.3.15 11.3.16 Struttura dei file SBO...........................................................................................................173 Informazioni sul file di configurazione _trace.ini.....................................................................152 Attivazione di registri e analisi nel file cs.cfg.........................................................................156 Attivazione di registri e analisi in modalità libreria..................................................................156 Attivazione di registri e analisi in modalità server..................................................................157 Lettura di registri e analisi.....................................................................................................157 Attivazione di registri e analisi per il client OLAP..................................................................159 Esempio di registro..............................................................................................................159 File di configurazione per l'accesso ai dati............................................................................161 File SBO installati.................................................................................................................162 Visualizzazione e modifica dei file SBO................................................................................168 Personalizzazione dei file SBO ............................................................................................168 Verifica dinamica delle connessioni......................................................................................169 Proprietà del driver JDBC....................................................................................................170 Informazioni sui driver ODBC DataDirect.............................................................................170 Abilitazione dell'uso di driver DataDirect con marchio...........................................................171 Descrizione dei parametri SBO............................................................................................174 Parametri SBO comuni.........................................................................................................175 Array Bind Available.............................................................................................................176 Array Bind Size....................................................................................................................176 Array Fetch Available...........................................................................................................176 Dimensioni array fetch..........................................................................................................177 BigDecimal Max Display Size...............................................................................................179 Binary Max Length...............................................................................................................179 Bucket Split Size..................................................................................................................180 Catalog Separator................................................................................................................180 CharSet Table......................................................................................................................181 Description File....................................................................................................................181 Dictionary Transaction Mode................................................................................................182 Driver Capabilities................................................................................................................182 Driver Name.........................................................................................................................183 Escape Character.................................................................................................................183 Extensions...........................................................................................................................184 Family..................................................................................................................................184 2013-07-02 Sommario 11.3.17 11.3.18 11.3.19 11.3.20 11.3.21 11.3.22 11.3.23 11.3.24 11.3.25 11.3.26 11.3.27 11.3.28 11.3.29 11.3.30 11.3.31 11.3.32 11.3.33 11.3.34 11.3.35 11.3.36 11.3.37 11.3.38 11.3.39 11.3.40 11.3.41 11.4 11.4.1 11.5 11.5.1 11.6 11.6.1 11.6.2 11.6.3 11.6.4 11.6.5 11.6.6 11.6.7 11.6.8 11.6.9 11.6.10 11.7 9 Force Execute......................................................................................................................185 Identifier Case......................................................................................................................185 Identifier Quote String..........................................................................................................186 Include Synonyms................................................................................................................186 Integer Max Length..............................................................................................................187 Introscope Available.............................................................................................................187 Max Rows Available.............................................................................................................188 Native Int64 Available...........................................................................................................188 Optimize Execute.................................................................................................................189 Owners Available.................................................................................................................189 Qualifiers Available...............................................................................................................190 Query TimeOut Available......................................................................................................190 Quote Identifiers..................................................................................................................191 Skip SAML SSO..................................................................................................................191 SQL External File.................................................................................................................192 SQL Parameter File..............................................................................................................192 SSO Available......................................................................................................................193 Strategies File......................................................................................................................193 Lunghezza massima.............................................................................................................194 Temp Data Dir......................................................................................................................195 Transactional Available.........................................................................................................195 Tipo......................................................................................................................................196 Unicode...............................................................................................................................196 URL Format.........................................................................................................................197 XML Max Size......................................................................................................................198 Parametri SBO JavaBean.....................................................................................................198 JavaBean Class...................................................................................................................198 Parametri SBO JCO............................................................................................................199 ERP Max Rows....................................................................................................................199 Parametri SBO JDBC..........................................................................................................199 Connection Shareable..........................................................................................................200 Escape Character Available..................................................................................................200 ForeignKeys Available..........................................................................................................201 Get Extended Column..........................................................................................................201 JDBC Class.........................................................................................................................202 PrimaryKey Available............................................................................................................202 PVL Available.......................................................................................................................202 Shared Connection..............................................................................................................203 JDBC ResultSet Type..........................................................................................................203 JDBC ResultSet Concurrency.............................................................................................204 Parametri SBO OData..........................................................................................................205 2013-07-02 Sommario 10 11.7.1 11.8 11.8.1 11.8.2 11.8.3 11.8.4 11.8.5 11.8.6 11.8.7 11.8.8 11.8.9 11.9 11.9.1 11.9.2 11.10 11.10.1 11.11 11.11.1 11.11.2 11.11.3 11.11.4 11.11.5 11.12 11.12.1 Enforce Max Protocol Version..............................................................................................205 Capitolo 12 Configurazione dei parametri delle funzionalità dei database............................................217 12.1 12.2 12.2.1 12.3 12.4 12.5 Informazioni sui parametri delle funzionalità dei database......................................................217 Capitolo 13 Riferimento ai parametri PRM.............................................................................................221 13.1 13.1.1 13.1.2 13.1.3 13.1.4 13.1.5 Riferimento alla sezione Configuration dei file PRM..............................................................221 Parametri SBO ODBC.........................................................................................................205 CharSet...............................................................................................................................206 Connection Status Available................................................................................................206 Cost Estimate Available.......................................................................................................207 Empty String........................................................................................................................207 ODBC Cursors....................................................................................................................207 SQLDescribeParam Available..............................................................................................208 SQLMoreResults Available..................................................................................................208 Use DataDirect OEM Driver.................................................................................................209 V5toV6DriverName.............................................................................................................209 Parametri SBO OLE DB.......................................................................................................210 Enumerator CLSID...............................................................................................................210 Provider CLSID....................................................................................................................210 Parametri SBO OLAP OLE DB.............................................................................................211 MSOlap CLSID....................................................................................................................211 Parametri SBO Sybase........................................................................................................211 Driver Behavior....................................................................................................................212 Password Encryption............................................................................................................212 Quoted Identifier..................................................................................................................212 Recover Errors.....................................................................................................................213 Text Size..............................................................................................................................213 Parametri SBO Teradata......................................................................................................214 Replace Current Owner With Database...............................................................................214 Informazioni sui file PRM......................................................................................................217 Struttura dei file dei parametri PRM.....................................................................................218 Visualizzazione e modifica dei file PRM................................................................................219 Visualizzazione e modifica di un file di testo della guida alle funzioni.....................................220 Modifica del testo della guida per una funzione PRM............................................................220 ANALYTIC_CLAUSE...........................................................................................................221 ANALYTIC_FUNCTIONS.....................................................................................................222 CALCULATION_FUNCTION................................................................................................222 CONSTANT_SAMPLING_SUPPORTED..............................................................................223 DISTINCT............................................................................................................................223 2013-07-02 Sommario 11 13.1.6 13.1.7 13.1.8 13.1.9 13.1.10 13.1.11 13.1.12 13.1.13 13.1.14 13.1.15 13.1.16 13.1.17 13.1.18 13.1.19 13.1.20 13.1.21 13.1.22 13.1.23 13.1.24 13.1.25 13.1.26 13.1.27 13.1.28 13.1.29 13.1.30 13.1.31 13.1.32 13.1.33 13.1.34 13.1.35 13.1.36 13.1.37 13.1.38 EXT_JOIN............................................................................................................................224 Capitolo 14 Riferimento per la conversione dei tipi di dati.....................................................................239 14.1 14.1.1 14.1.2 14.1.3 14.1.4 14.1.5 Conversione dei tipi di dati ..................................................................................................239 FULL_EXT_JOIN..................................................................................................................224 GROUP_BY.........................................................................................................................225 GROUP_BY_SUPPORTS_COLUMN_INDEX......................................................................225 GROUP_BY_SUPPORTS_COMPLEX.................................................................................226 GROUP_BY_SUPPORTS_CONSTANT...............................................................................226 HAVING...............................................................................................................................227 INTERSECT.........................................................................................................................227 INTERSECT_ALL.................................................................................................................228 INTERSECT_IN_SUBQUERY...............................................................................................228 JOIN....................................................................................................................................229 LEFT_EXT_JOIN...................................................................................................................229 LEFT_OUTER.......................................................................................................................229 LIKE_SUPPORTS_ESCAPE_CLAUSE.................................................................................230 MINUS.................................................................................................................................230 MINUS_ALL........................................................................................................................231 MINUS_IN_SUBQUERY......................................................................................................231 ORDER_BY.........................................................................................................................232 ORDER_BY_REQUIRES_SELECT........................................................................................232 ORDER_BY_SUPPORTS_COLUMN_INDEX.......................................................................232 PERCENT_RANK_SUPPORTED..........................................................................................233 RANK_SUPPORTED...........................................................................................................233 RIGHT_EXT_JOIN................................................................................................................234 RIGHT_OUTER....................................................................................................................234 SEED_SAMPLING_SUPPORTED........................................................................................235 SELECT_SUPPORTS_NULL................................................................................................235 SUBQUERY_IN_FROM.......................................................................................................236 SUBQUERY_IN_IN..............................................................................................................236 SUBQUERY_IN_WHERE.....................................................................................................236 TECHNICAL_COLUMN_NAME_PATTERN..........................................................................237 UNION.................................................................................................................................237 UNION_ALL.........................................................................................................................238 UNION_IN_SUBQUERY......................................................................................................238 ABAP...................................................................................................................................240 File CSV..............................................................................................................................241 JDBC...................................................................................................................................242 ODBC..................................................................................................................................244 OData..................................................................................................................................247 2013-07-02 Sommario 14.1.6 14.1.7 14.1.8 14.1.9 14.2 14.3 OLE DB...............................................................................................................................248 Appendice A Ulteriori informazioni...........................................................................................................257 Indice 12 Oracle OCI...........................................................................................................................250 Sybase CTL.........................................................................................................................251 XML e servizi Web...............................................................................................................253 Restrizione dei dati a lunghezza variabile di grandi dimensioni...............................................254 Mappatura dei tipi di dati per gli universi con più origini........................................................254 259 2013-07-02 Cronologia delle versioni del documento Cronologia delle versioni del documento La seguente tabella contiene una panoramica delle modifiche principali apportate al documento. Versione Data Modifiche Aggiunta nuova connettività Sybase IQ 15 tramite ODBC e JDBC su tutte le piattaforme. Piattaforma SAP BusinessObjects Business Intelligence 4.0 pacchetto di supporto 2 Per ODBC Data Source Administrator Tool, vedere Supporto Microsoft Windows a 64 bit. Maggio 2011 Per il supporto della connettività JDBC in modalità 3-tier, vedere Creazione di connessioni JDBC . Per la restrizione della compatibilità con le versioni precedenti di BusinessObjects OpenConnectivity, vedere CSV OpenDriver. Per la documentazione sul parametro SBO Owners Available, vedere Owners Available. 13 2013-07-02 Cronologia delle versioni del documento 14 Versione Data Piattaforma SAP BusinessObjects Business Intelligence 4.0 Feature Pack 3 Marzo 2012 Modifiche 2013-07-02 Cronologia delle versioni del documento Versione Data Modifiche Per le modalità di distribuzione di Distribuzione, vedere Modalità di distribuzione. Per informazioni sui Servizi di connettività, vedere Servizi di connessione. Per l'installazione dei driver ODBC, vedere Installazione dei driver ODBC. Nuova funzionalità: supporto Single Sign-On per nuove connettività, vedere Supporto Single Sign On. Per aggiornamenti sul supporto delle stored procedure di Teradata, vedere Stored procedure Teradata. Nuova funzionalità: supporto di stored procedure Oracle internamente a un pacchetto, vedere Funzionalità di database supportate. Nuova funzionalità: meccanismo di bilanciamento del carico, vedere Bilanciamento del carico:. Nuova funzionalità: allocazione della memoria per il Servizio di connettività nativo (64 bit), vedere Allocazione di memoria. Per le attività di Connection Server in Introscope, vedere Attività nella workstation CA Wily Introscope. Per un elenco di nomi delle cartelle in cui inserire i file JAR per le connessioni JDBC, vedere Riferimento per la posizione del file JAR. Nuova funzionalità: CSV OpenDriver migliorato, vedere CSV OpenDriver. Nuova funzionalità: driver SAP ERP, vedere Driver SAP ERP. Per informazioni dettagliate sulle connessioni (Apache Hadoop HIVE, IBM DB2, Oracle Essbase, Salesforce.com e SAP HANA), vedere il capitolo di riferimento sulle connessioni. Per le SAP Note sull'autorizzazione degli utenti per SAP NetWeaver BW, vedere Connessioni SAP NetWeaver BW. Per l'attivazione dell'analisi dei driver, vedere Attivazione di registri e analisi di Connection Server e dei relativi driver. Per un aggiornamento generale del capitolo di riferimento per la conversione dei tipi di dati, vedere Conversione dei tipi di dati . Per la restrizione delle dimensioni per i dati a lunghezza variabile, vedere Restrizione dei dati a lunghezza variabile di grandi dimen- 15 2013-07-02 Cronologia delle versioni del documento Versione Data Modifiche sioni. Piattaforma SAP BusinessObjects Business Intelligence 4.0 Support Package 4 Informazioni dettagliate sulle connessioni salesforce.com, vedere Connessioni salesforce.com. Giugno 2012 Supporto del database SAP HANA 1.0 SPS 04, vedere Connessioni SAP HANA. Nuovo parametro PRM, vedere CALCULATION_FUNCTION. Piattaforma SAP BusinessObjects Business Intelligence 4.0 Pacchetto di supporto 5 Piattaforma SAP BusinessObjects Business Intelligence 4.0 Support Package 6 16 Novembre 2012 Aprile 2013 Nuovo parametro del file cs.cfg, vedere Temp Data Dir. Nuovo parametro SBO per il driver SAP ERP, vedere Lunghezza massima. Sono disponibili nuove connettività. Per ulteriori informazioni, consultare la Product Availability Matrix. Per la risoluzione dei problemi delle connessioni IBM Informix, vedere Connessioni IBM Informix. 2013-07-02 Cronologia delle versioni del documento Versione Data Modifiche Per informazioni sui nuovi driver OData, XML e di servizio Web, vedere Driver di accesso ai dati. Per informazioni sul supporto del Single Sign On per Teradata 13, Teradata 14 e Sybase IQ, vedere Supporto Single Sign On. Per informazioni sul supporto delle stored procedure SAP HANA, vedere Stored procedure SAP HANA. Per informazioni sulle connessioni SAP ERP e la mappatura semplificata delle colonne di input opzionali, vedere Driver SAP ERP - Accesso alle funzioni ABAP. Per informazioni sulle connessioni SAP HANA, il supporto della nuova versione SAP HANA SPS 05, le connessioni OLAP, il Single Sign On tramite il protocollo SAML, il protocollo SSL e le piattaforme UNIX a 64 bit tramite ODBC, vedere Connessioni SAP HANA. Piattaforma SAP BusinessObjects Business Intelligence 4.1 Maggio 2013 Per informazioni sul supporto di connessioni HIVE 0.9 tramite JDBC, vedere Connessioni HIVE. Per informazioni sul nuovo registro dell'attività di Connection Server, vedere Attivazione di registri e analisi di Connection Server e dei relativi driver. Per informazioni su come attivare i registri del client OLAP, vedere Attivazione di registri e analisi per il client OLAP. Per informazioni sul supporto dei driver ODBC DataDirect 7.0, vedere Informazioni sui driver ODBC DataDirect. Per informazioni sul nuovo parametro SBO per qualsiasi driver di accesso ai dati, vedere Dictionary Transaction Mode. Per informazioni sui nuovi parametri SBO per le connessioni MySQL, vedere JDBC ResultSet Type e JDBC ResultSet Concurrency. Per informazioni sul nuovo parametro SBO per le connessioni Teradata, vedere Replace Current Owner With Database. Per informazioni sul nuovo parametro SBO per ignorare SAML con le connessioni SAP HANA, vedere Skip SAML SSO. 17 2013-07-02 Cronologia delle versioni del documento 18 2013-07-02 Introduzione al manuale di accesso ai dati Introduzione al manuale di accesso ai dati 2.1 Informazioni sul manuale Nel Manuale dell'accesso ai dati vengono illustrate le funzionalità di Connection Server e la modalità di configurazione di Connection Server per abilitare le connessioni della piattaforma SAP BusinessObjects Business Intelligence 4.1 ai database di produzione. Nel Manuale dell'accesso ai dati sono fornite le seguenti informazioni: • concetti fondamentali di Connection Server • Informazioni sui driver di accesso ai dati per origini dati CSV, OData, SAP ERP e XML • creazione di una connessione JDBC, ODBC o Javabean • configurazione dei parametri di accesso ai dati Nota: Fornisce anche informazioni per la configurazione delle connessioni in SAS, SAP NetWeaver BW per universi con più origini e connessioni a MS Analysis Services mediante XMLA. Queste connessioni non si basano su Connection Server. 2.2 Destinatari Il Manuale dell'accesso ai dati si rivolge ai seguenti destinatari: • • Utenti SAP BusinessObjects responsabili della creazione di connessioni alle origini dati Amministratori di sistema responsabili di configurazione, gestione e manutenzione di un'installazione della piattaforma BI 2.3 Novità Il livello di accesso ai dati della piattaforma BI presenta le seguenti modifiche: • 19 Sono disponibili nuove connettività tramite Connection Server. Consultare Product Availability Matrix per maggiori informazioni. 2013-07-02 Introduzione al manuale di accesso ai dati • Le connessioni esistenti alle origini dati riportate di seguito continueranno a funzionare, ma non sarà possibile creare nuove connessioni. • DB2 for z/OS v8, DB2 UDB v8 e DB2 v9.1 • GreenPlum 3 • MS Access 2003, MS Excel 2003, MS SQL Server 2005 e MS Analysis Services 2005 • Progress OpenEdge 10 • Sybase IQ 12.7, Sybase ASE 15 e Sybase SQL Anywhere 10 • Sono disponibili nuovi driver di accesso ai dati per le seguenti origini dati: • Origini dati OData, inclusi i servizi forniti da SAP NetWeaver Gateway • Documenti XML • Servizi Web • • Il driver SAP ERP offre una mappatura semplificata delle colonne di input opzionali. Per le connessioni SAP HANA, il livello di accesso ai dati supporto le seguenti funzionalità: • Nuova versione di SAP HANA SPS 05 • Connessioni OLAP • Single Sign On con il protocollo SAML • Protocollo SSL • Sistemi operativi UNIX a 64 bit tramite ODBC • Stored procedure SAP HANA tramite JDBC e ODBC • • Il livello di accesso ai dati supporta il Single Sign On per le connessioni Teradata e Sybase IQ. Il livello di accesso ai dati supporta driver DataDirect ODBC 7.0 con e senza marchio per connessioni MS SQL Server su UNIX. Nei seguenti casi, il livello di accesso ai dati supporta dati di lunghezza variabile di grandi dimensioni per file binari e caratteri: • Connection Server in modalità libreria tramite livelli di rete ODBC, JDBC, OCI, CTLib, DB2 CAE e OLE DB • Connection Server in modalità server per le sole connessioni JDBC • • • • • Nuovi parametri SBO per connessioni MySQL, OData, XML, Servizi Web e Teradata Nuovo parametro SBO per consentire la modalità di transazione durante il recupero di metadati Nuovo parametro SBO per ignorare l'uso del protocollo SAML nelle connessioni SAP HANA È disponibile un nuovo registro per analizzare e registrare le connessioni per amministratori e sviluppatori. Argomenti correlati • Driver OData • Driver SAP ERP - Accesso a InfoSet e query SAP • Driver XML • Driver di servizio Web • Stored procedure SAP HANA • Connessioni SAP HANA • Attivazione di registri e analisi di Connection Server e dei relativi driver • Informazioni sui driver ODBC DataDirect 20 2013-07-02 Introduzione al manuale di accesso ai dati 2.4 Attività principali Il Manuale dell'accesso ai dati fornisce le informazioni essenziali per gestire i parametri di configurazione e stabilire le connessioni. Per ciascuna delle attività che seguono fare riferimento alla sezione appropriata: • • • • • • Come si imposta la modalità di funzionamento del server? Come si scelgono i driver da caricare? Come si configurano i driver per l'accesso ai dati? Come si verifica la configurazione delle connessioni? Come si creano le connessioni JDBC? Modalità di creazione delle connessioni SAP HANA Nota: per attività amministrative come l'avvio e l'interruzione del Connection Server, la gestione di proprietà e le metriche, fare riferimento al Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. Argomenti correlati • Configurazione della modalità di distribuzione • Configurazione dei driver da caricare • Visualizzazione e modifica dei file SBO • Esecuzione dello strumento cscheck • Creazione di connessioni JDBC • Connessioni SAP HANA 2.5 Convenzioni presenti in questo manuale Nel presente manuale, la variabile dir-installazione-connectionserver è il percorso principale di installazione per i file di accesso ai dati utilizzati dagli strumenti client di SAP BusinessObjects. In Microsoft Windows, dir-installazione-connectionserver predefinito corrisponde al percorso C:\Programmi\SAP Business Objects\SAP BusinessObjects Enterprise XI 4.0\dataAccess. La variabile dir-installazione-bip è il percorso principale di installazione della piattaforma BI o degli strumenti client. Su MS Windows (64-bit), corrisponde alla directory C:\Programmi (x86)\SAP Business Objects\SAP BusinessObjects Enterprise XI 4.0. Avvertenza: nei file di configurazione dell'accesso ai dati, utilizzare il simbolo di escape \ con la barra rovesciata \ nei percorsi dei file nel caso in cui si distribuisca la piattaforma BI su Microsoft Windows. 21 2013-07-02 Introduzione al manuale di accesso ai dati 22 2013-07-02 Introduzione all'accesso ai dati Introduzione all'accesso ai dati 3.1 Informazioni su Connection Server Connection Server è il software di accesso ai dati che gestisce la connessione tra un'applicazione SAP BusinessObjects e un'origine dati. Connection Server consente ad applicazioni quali Universe Design Tool, Information Design Tool e SAP BusinessObjects Web Intelligence di connettersi ed eseguire le query su un'origine dati. Connection Server non è dotato di un'interfaccia utente. È possibile creare e amministrare le connessioni dall'interfaccia utente delle applicazioni oppure modificando i file di configurazione di Connection Server. • Creazione delle connessioni È possibile creare connessioni utilizzando la procedura guidata di connessione degli strumenti client della piattaforma BI. Nota: la procedura guidata di connessione di Universe Design Tool è la procedura guidata Nuova connessione. In Information Design Tool, può essere la procedura guidata Nuova connessione relazionale o la procedura guidata Nuova connessione OLAP. Per informazioni sull'utilizzo della procedura guidata di connessione, vedere i manuali utente delle applicazioni. • Ottimizzazione dei dati di accesso È possibile ottimizzare il modo in cui i dati transitano attraverso Connection Server modificando i file di configurazione per l'accesso ai dati. Si tratta di file in formato XML installati con Connection Server. È possibile impostare i valori dei parametri da applicare a un driver specifico di accesso ai dati o a tutti i driver di accesso ai dati installati. 3.2 Componenti di una connessione Una connessione di accesso ai dati è costituita dai seguenti componenti: • Connection Server è il software che gestisce la connessione tra l'applicazione e l'origine dati. Ad esempio, Connection Server gestisce le richieste di dati provenienti dall'applicazione. • 23 Un driver di accesso ai dati è il componente software specifico del database che gestisce la connessione tra Connection Server e il middleware del database. 2013-07-02 Introduzione all'accesso ai dati • I file di configurazione definiscono i parametri per la configurazione della connessione tra i sistemi seguenti: • l'applicazione e Connection Server • l'applicazione e il driver di accesso ai dati • Connection Server il driver di accesso ai dati 3.2.1 Architettura di sistema Il diagramma che segue descrive in dettaglio dove vengono inseriti Connection Server e i driver di accesso ai dati in una configurazione SAP BusinessObjects. 3.2.2 Driver di accesso ai dati I driver di accesso ai dati consentono la connessione tra Connection Server e un'origine dati. Un database richiede un driver di accesso ai dati per consentire l'accesso da parte di un'applicazione SAP BusinessObjects. 24 2013-07-02 Introduzione all'accesso ai dati Le applicazioni SAP BusinessObjects includono driver di accesso ai dati che è possibile utilizzare per configurare le connessioni ai database. I driver di accesso ai dati inclusi possono dipendere dalla licenza in uso. Per poter creare una connessione a un database per il quale non si dispone dei relativi driver, è necessario per prima cosa ottenere i driver richiesti. Per ottenere un driver sono disponibili le seguenti opzioni: • Contattare il rappresentante SAP di fiducia per determinare se è disponibile un driver e se si dispone della licenza per utilizzarlo. • Utilizzare il DDK (Driver Development Kit) per sviluppare un driver da utilizzare. Contattare il rappresentante SAP per maggiori dettagli. Quando si crea una nuova connessione, si seleziona il driver di accesso ai dati adatto all'origine dati di destinazione. Ad esempio, se si accede a un database Oracle 10g, è necessario installare il middleware adeguato (client Oracle 10g), quindi il driver di accesso ai dati Oracle SAP BusinessObjects. Avvertenza: I driver di accesso ai dati del bean Excel (bean_excel.jar) e CSV (dbd_open_sample.jar) sono esempi di driver. Non vanno utilizzati così come sono, ma come punti di partenza per sviluppare driver più complessi mediante DDK. Per un elenco aggiornato dei driver di accesso ai dati supportati, visitare il SAP Service Marketplace all'indirizzo http://service.sap.com/bosap-support o contattare il rappresentante SAP di fiducia. Per ulteriori informazioni su DDK, consultare Data Access Driver Java SDK Developer Guide all'indirizzo http://boc.sdn.sap.com. 3.3 File di configurazione per l'accesso ai dati I file di configurazione per l'accesso ai dati sono forniti con l'installazione della piattaforma BI. e si possono suddividere nei livelli seguenti: • Livello globale Il file di configurazione cs.cfg viene applicato a tutte le connessioni. • Driver level I file di configurazione SBO viene applicato a driver specifici. Oltre ai file di configurazione che controllano una connessione, a ciascun driver di accesso ai dati è associato un file di configurazione PRM. I file PRM controllano il modo in cui un'applicazione genera codice SQL in base alle funzionalità del software del database. Vengono utilizzati da applicazioni come Information Design Tool. 25 2013-07-02 Introduzione all'accesso ai dati 3.3.1 Informazioni sul file di configurazione globale cs.cfg Il file di configurazione globale cs.cfg utilizzato da tutti i driver di accesso ai dati è installato nel seguente percorso: • dir-installaz-connectionserver \connectionServer Il file cs.cfg contiene i parametri che vengono applicati a tutti i driver di accesso ai dati installati. Argomenti correlati • Informazioni sui parametri globali 3.3.2 Informazioni sui file di configurazione dei driver I file di configurazione utilizzati dai driver di accesso ai dati vengono installati nel seguente percorso: • su un sistema Microsoft Windows: dir-installazione-connectionserver \connectionServer\RDBMS • su un sistema Unix: dir-installazione-connectionserver/connectionServer/RDBMS dove RDBMS è il nome del livello di rete o del middleware del database che utilizza il file di configurazione. I file elencati di seguito contengono parametri riguardanti i driver di accesso ai dati installati. File specifico di driver <driver>.sbo 26 È possibile modificarlo Descrizione Esempio Sì Ogni driver di accesso ai dati utilizza un file SBO. Definisce la configurazione specifica della connettività per ogni driver e database di destinazione. oracle.sbo 2013-07-02 Introduzione all'accesso ai dati File specifico di driver <driver>.prm <driver><lin gua>.cod È possibile modificarlo Descrizione Esempio Sì Ogni driver di accesso ai dati utilizza un file PRM. Definisce i parametri che determinano il modo in cui un'applicazione genera l'SQL. oracle.prm No Ogni driver di accesso ai dati utilizza un file COD. Contiene le informazioni relative alle definizioni della connessione. Definisce i campi visualizzati quando viene creata una nuova connessione. oracleen.cod Nota: Questi file non devono essere modificati. <driver>.rss <driver>.stg No Ogni driver di accesso ai dati utilizza un file RSS. Memorizza le istruzioni SQL predefinite utilizzate da Connection Server. oracle.rss No Il driver di accesso ai dati può utilizzare un file di strategia. Per ulteriori informazioni, consultare il riferimento ai parametri SBO. oracle.stg Argomenti correlati • Descrizione dei parametri SBO • Riferimento alla sezione Configuration dei file PRM • Informazioni sui parametri delle funzionalità dei database 27 2013-07-02 Introduzione all'accesso ai dati 3.4 Modalità di distribuzione Connection Server può essere eseguito nelle seguenti modalità di distribuzione: • Modalità libreria (in-proc) Connection Server è incluso nel processo client. La maggior parte delle applicazioni SAP BusinessObjects utilizza Connection Server in modalità Libreria. • Modalità server Connection Server è un server CORBA a cui si accede in remoto. Connection Server gestisce i client CORBA e HTTP per supportare rispettivamente le modalità di distribuzione 2-tier e di livello Web. Consultare il Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence per maggiori informazioni sugli scenari di distribuzione. Argomenti correlati • Impostazione della modalità di distribuzione • Configurazione della modalità di distribuzione • Configurazione dei driver da caricare 3.5 Servizi di connessione Tre istanze del server Connection Server sono dotate dell'installazione predefinita della piattaforma BI. Tali istanze sono raggruppate in Servizi di connettività in Central Management Console (CMC). I server Connection Server ospitano i seguenti servizi: • • Servizio di connettività nativo (64 bit) Servizio di connettività nativo (a 32 bit solo su MS Windows) Adaptive Processing Server ospita il servizio di connessione adattivo, che consente alle applicazioni degli utenti di accedere in remoto alle origini dati basate su Java. All'avvio, i Servizi di connettività mostrano l'elenco di origini dati supportate nel cluster della piattaforma BI, in modo che le applicazioni SAP BusinessObjects possano individuare e utilizzare l'istanza server appropriata. Le applicazioni cercano le origini dati tramite Connection Server innanzitutto in modalità libreria e quindi in modalità server. Connessione e servizio Quando Connection Server è utilizzato in modalità libreria, l'elenco di origini dati disponibili è definito dai driver di accesso ai dati e dal middleware installato nel computer locale. Quando Connection Server 28 2013-07-02 Introduzione all'accesso ai dati è utilizzato in modalità server, l'elenco di origini dati include anche quelle supportate da ogni istanza server eseguita nel sistema di back-end della piattaforma BI. Ogni istanza server supporta un sottoinsieme delle origini dati supportate al livello di accesso ai dati. Il sottoinsieme dipende dai seguenti parametri: • • • • la tecnologia di implementazione del server CS (C++ o Java) il sistema operativo host (UNIX o MS Windows) i driver selezionabili durante l'installazione della piattaforma BI le origini dati attive selezionabili per ogni istanza server nella CMC Nella tabella seguente è indicato quale servizio di connettività può essere utilizzato dai singoli tipi di connessione. Connessione Servizio di connettività Descrizione Tutte le origini dati native a 64 bit Servizio di connessione nativo Supporto per ODBC, OLE DB, OCI e così via. Tutte le origini dati native a 32 bit Servizio di connessione nativo Supporto delle origini dati disponibile solo in versione a 32 bit. Questo servizio è disponibile sono su MS Windows. Origini dati basate su Java Servizio di connessione adattivo Supporto per tutto il middleware basato su Java. Questo servizio è un'implementazione Java basato sul framework Platform Java Service (PJS). Esempio: • • • 29 Un'origine dati nativa a 64 bit è il database Oracle tramite Oracle OCI. Un'origine dati nativa a 32 bit è MS Excel 2007 tramite ODBC. Un'origine dati basata su Java è MS SQL Server 2008 R2 tramite JDBC. 2013-07-02 Introduzione all'accesso ai dati 30 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati Informazioni sulle caratteristiche specifiche dell'accesso ai dati 4.1 Supporto per sistemi operativi a 64 bit SAP BusinessObjects fornisce release della piattaforma BI per i seguenti sistemi operativi: • • Versioni a 32 bit di Microsoft Windows Versioni a 64 bit di Microsoft Windows e versioni UNIX Il livello di accesso ai dati fornisce quindi driver di accesso ai dati che possono essere eseguiti in ambienti a 32 o a 64 bit. Le sezioni seguenti spiegano come questo influisce sul supporto per il middleware del database in ambienti a 32 bit o a 64 bit. Per ottenere l'elenco completo delle origini dati supportate sui sistemi operativi a 64 bit, consultare Product Availability Matrix Nota: il DDK fornisce esempi di driver di accesso ai dati che possono essere eseguiti in ambienti a 32 o a 64 bit. Per ulteriori informazioni su DDK, consultare Data Access Driver Java SDK Developer Guide. 4.1.1 Supporto UNIX a 64 bit Connection Server viene fornito con la piattaforma BI e quindi supporta l'installazione in ambienti UNIX a 64 bit come server remoto o in-proc. Avvertenza: Assicurarsi di avere installato il middleware a 64 bit per eseguire le connessioni al database tramite Connection Server. alcuni fornitori non prevedono middleware a 64 bit per i seguenti database e livelli di rete in ambienti UNIX. Questi sono disponibili solo in Microsoft Windows: • • • 31 DB2 UDB for iSeries V5 con Client Access AS400 DB2 UDB for iSeries V6 con Client Access AS400 DB2 for i v6.1 con Client Access AS400 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati • • • • • DB2 for i v7.1 con Client Access AS400 Origine dati generica tramite OLE DB MS Access 2010 tramite ODBC MS Excel 2010 tramite ODBC MS SQL Server 2008, 2008 R2 e 2012 tramite OLE DB 4.1.2 Supporto Microsoft Windows a 64 bit Connection Server viene fornito con la piattaforma BI e quindi supporta l'installazione in ambienti MS Windows sia a 32 bit (come server in-proc) che a 64 bit (come server remoto e in-proc). I fornitori non prevedono middleware a 64 bit per i seguenti database tramite ODBC su Microsoft Windows: • • • • • • • Database Ingres 9 MS Access 2007 MS Excel 2007 PostgreSQL 8 File di testo Server delle query di Data Federator XI 3.0 Salesforce.com Microsoft Windows a 64 bit inoltre non supporta i seguenti database OLAP e il relativo middleware: • • • SAP BW tramite SAP BAPI MS Analysis Services tramite OLE DB per OLAP Oracle Essbase tramite il middleware Essbase Per tutte queste origini dati, il livello di accesso ai dati è in grado di funzionare con il middleware a 32 bit nelle versioni a 64 bit di Microsoft Windows. Questa funzionalità è gestita attraverso una distribuzione specifica costituita da due Connection Server eseguiti contemporaneamente in modalità server. Il primo è a 32 bit ed esegue le connessioni alle origini dati che non gestiscono il middleware a 64 bit e il secondo è a 64 bit ed esegue le connessioni alle altre origini dati. Poiché il file cs.cfg è comune a entrambi, i due server condividono la stessa configurazione. Limitazione: Questa architettura implica l'impossibilità di eseguire lo stesso driver di accesso ai dati su entrambi i server. Tuttavia, è possibile stabilire una connessione ODBC generica sul Connection Server a 32 bit o sul Connection Server a 64 bit, ma non su entrambi i server contemporaneamente. Argomenti correlati • Dimensioni array fetch 32 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati 4.1.3 Installazione dei driver ODBC Per le installazioni di Information Design Tool o Universe Design Tool in un sistema operativo Windows a 32 bit, è necessario definire i driver per le origini dati ODBC da creare, sottoporre a test e cui accedere utilizzando l'amministratore dell'origine dati ODBC, disponibile nella posizione seguente sul computer fisico in cui è installato lo strumento: • C:\Windows\System32\odbcad32.exe Per le installazioni di Information Design Tool o Universe Design Tool in un sistema operativo Windows a 64 bit, è necessario definire i driver per le origini dati ODBC da creare, sottoporre a test e cui accedere utilizzando la versione a 32 bit dell'amministratore dell'origine dati ODBC, disponibile nella posizione seguente sul computer fisico in cui è installato lo strumento: • C:\Windows\SysWOW64\odbcad32.exe Per Information Design Tool, le origini dati ODBC da utilizzare tramite i componenti server vengono definite mediante l'amministratore dell'origine dati ODBC, disponibile nella posizione seguente sul computer fisico in cui sono installati i componenti server: • • versione a 64 bit: C:\Windows\System32\odbcad32.exe (consigliata in caso di presenza di middleware del database a 64 bit) versione a 32 bit: C:\Windows\SysWOW64\odbcad32.exe (utilizzare se è presente solo middleware del database a 32 bit) Nota: Se Information Design Tool o Universe Design Tool utilizza il nome dell'origine dati (DSN) ODBC per le origini dati degli universi, è necessario creare DSN con gli stessi nomi sul computer fisico in cui sono installati i componenti server delle applicazioni per la creazione di report di SAP BusinessObjects che utilizzano gli universi pubblicati. Per ulteriori informazioni, consultare il Manuale di installazione della piattaforma SAP BusinessObjects Business Intelligence 4.2 Supporto Single Sign On La piattaforma BI prevede l'autenticazione Single Sign On (SSO) quando è installata sulle seguenti piattaforme e con i seguenti tipi di connessione: 33 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati Origine dati Descrizione MS Analysis Services su Microsoft Windows Il Single Sign On alla piattaforma BI viene garantito da Windows AD con Kerberos. MS SQL Server mediante ODBC o OLE DB su Microsoft Windows Il Single Sign On alla piattaforma BI viene garantito da Windows AD con Kerberos. Oracle tramite OCI su Microsoft Windows Il Single Sign On alla piattaforma BI viene garantito da LDAP. Oracle EBS tramite OCI su tutte le piattaforme SSO viene abilitato installando e configurando il plug-in di autenticazione fornito con la piattaforma. Gli utenti accedono alla piattaforma BI da un'applicazione SAP BusinessObjects utilizzando le proprie credenziali EBS (nome utente e password). SAP BW tramite OLAP BAPI su tutte le piattaforme SSO viene abilitato installando e configurando l'autenticazione SAP. Gli utenti accedono alla piattaforma BI da un'applicazione SAP BusinessObjects utilizzando le proprie credenziali SAP BW. Sistemi SAP ERP tramite SAP Java Connectivity SSO viene abilitato installando e configurando (JCo) 3.x in tutte le piattaforme l'autenticazione SAP. Gli utenti accedono alla piattaforma BI da un'applicazione SAP BusinessObjects utilizzando le proprie credenziali SAP ERP. Database SAP HANA 1.0 tramite ODBC e JDBC Il servizio SSO fornito è l'SSO al database e utilizza su tutte le piattaforma e OLAP su Microsoft Win- Windows AD con Kerberos (in ODBC, JDBC e dows, Linux e AIX OLAP) o il protocollo SAML (in JDBC e OLAP). Gli utenti accedono alla piattaforma BI da un'applicazione SAP BusinessObjects utilizzando le proprie credenziali Windows AD. Database Sybase IQ tramite ODBC su Microsoft Il Single Sign On alla piattaforma BI viene garantito Windows da Windows AD con Kerberos. Teradata 13 e Teradata 14 tramite ODBC su Mi- Il Single Sign On alla piattaforma BI viene garantito crosoft Windows da Windows AD con Kerberos. Per ulteriori informazioni sul servizio SSO, fare riferimento al Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. 34 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati Argomenti correlati • Connessioni Oracle EBS • Driver SAP ERP • Connessioni SAP HANA 4.3 Stored procedure Connection Server è in grado di gestire i dati provenienti da origini dati ottenuti da query SQL o dall'esecuzione di stored procedure. Le stored procedure sono script SQL memorizzati come codice eseguibile in un sistema RDBMS. Possono ricevere argomenti e restituire dati. Nella piattaforma BI sono supportate le stored procedure relative ai seguenti database e livelli di rete: • • • • • • • DB2 UDB e iSeries mediante driver CLI Sybase Adaptive Server mediante CTLIB Javabean DB2 UDB, Derby, HSQL DB, Informix, MS SQL Server, MySQL 5, Oracle, SAP HANA e Sybase, tutti mediante JDBC Oracle mediante OCI DB2 iSeries, Informix, MS SQL Server, SAP HANA, Sybase ASIQ e Sybase SQL Anywhere, tutti mediante ODBC MS SQL Server mediante OLE DB 4.3.1 Funzionalità di database supportate Connection Server supporta solo le stored procedure che restituiscono dati sotto forma di insiemi di risultati, ovvero tabelle. Ciò significa che una stored procedure non può restituire numeri interi, stringhe o cursori e deve sempre contenere istruzioni SELECT. Inoltre, le stored procedure supportate non devono contenere parametri OUT o IN/OUT, ma solo parametri IN. e le istruzioni COMPUTE, PRINT, OUTPUT e STATUS contenute nelle stored procedure non vengono eseguite. Avvertenza: queste restrizioni non sono valide per le stored procedure di Oracle. Per maggiori dettagli sulle stored procedure di Oracle supportate, vedere la sezione successiva. Connection Server supporta le stored procedure di Oracle dentro un pacchetto. Il nome del pacchetto viene restituito come nome del catalogo. Questo comportamento è valido per i livelli di rete Oracle CI e JDBC. 35 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati Per ulteriori informazioni sull'utilizzo delle stored procedure, consultare il manuale dell'utente Universe Design Tool. 4.3.2 Stored procedure Oracle Sono supportate le seguenti stored procedure di Oracle: • • qualsiasi procedura PL/SQL che restituisca insiemi di risultati mediante REF CURSOR stored procedure PL/SQL che contengano un parametro IN/OUT della variabile REF CURSOR e nessun parametro OUT Nota: gli altri parametri IN/OUT del cursore della procedura vengono ignorati. Le seguenti stored procedure di Oracle non sono supportate: • • • • • qualsiasi procedura PL/SQL che non restituisca insiemi di dati mediante un parametro REF CURSOR qualsiasi procedura PL/SQL che contenga almeno un parametro OUT qualsiasi funzione PL/SQL qualsiasi procedura PL/SQL che contenga un parametro IN/OUT di tipo diverso da REF CURSOR, ad esempio VARRAY qualsiasi funzione di tabella PL/SQL Per accedere alle stored procedure di Oracle, è necessario eseguire alcune attività sul server in modo da consentire alla piattaforma BI di connettersi a una stored procedure. Tali attività vengono trattate nelle sezioni successive. 4.3.3 Creazione di un cursore all'interno di un pacchetto Nei database Oracle, un pacchetto è un oggetto di database contenente tipi PL/SQL, oggetti e programmi secondari correlati. Per creare una stored procedure di Oracle utilizzando un determinato cursore, è necessario creare prima il cursore all'interno di un pacchetto. • Nel sistema di amministrazione del database di Oracle, utilizzare l'istruzione seguente: CREATE or REPLACE PACKAGE catalog_data AS TYPE CatCurTyp IS REF CURSOR RETURN all_objects%ROWTYPE; END catalog_data; Avvertenza: la piattaforma BI non supporta le stored procedure incluse in pacchetti, solo quelle autonome. 36 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati 4.3.4 Creazione di una stored procedure Oracle Nella procedura che segue viene utilizzato il cursore catcurtyp, creato in precedenza nel pacchetto, e catalog_data.catcurtyp. • Eseguire una delle operazioni seguenti: a. Scrivere la seguente istruzione: CREATE or REPLACE PROCEDURE get_allobjects(cat_cv IN OUT catalog_data.catcurtyp) AS BEGIN OPEN cat_cv FOR SELECT * FROM all_objects; END; b. Scrivere la seguente istruzione con diversi parametri: CREATE or REPLACE PROCEDURE get_ownerobjects(owner_name IN varchar2, cat_cv IN OUT catalog_data.catcurtyp) AS BEGIN OPEN cat_cv FOR SELECT * FROM all_objects WHERE owner=owner_name; END; Nota: Consultare la documentazione Oracle per ulteriori informazioni sulla creazione di pacchetti e stored procedure. 4.3.5 Stored procedure SAP HANA Connection Server supporta stored procedure SAP HANA tramite JDBC e ODBC. Per creare stored procedure SAP HANA utilizzare la seguente sintassi: CREATE PROCEDURE <procedure_name> {LANGUAGE <lang>} {SQL SECURITY <mode>} {READS SQL DATA {WITH RESULT VIEW <view_name>}} AS BEGIN select ... from <table_name>; END LANGUAGE, SQL SECURITY e READS SQL DATA non sono obbligatori. Il linguaggio predefinito è SQLScript. Per ulteriori informazioni, consultare il documento SAP HANA Database SQLScript Guide. Esempio: Stored procedure semplice: CREATE PROCEDURE Proc LANGUAGE SQLSCRIPT READS SQL DATA AS BEGIN select * from CUSTOMER; END 37 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati Stored procedure con un parametro e una vista risultati: CREATE PROCEDURE ProcWithResultView(IN id int) LANGUAGE SQLSCRIPT READS SQL DATA WITH RESULT VIEW ProcView AS BEGIN select * from CUSTOMER where CUST_ID = :id; END 4.3.6 Stored procedure Teradata Connection Server supporta solo le macro Teradata quando la connessione stabilita utilizza ODBC. Avvertenza: Non supporta le stored procedure di Teradata in ODBC poiché queste non restituiscono alcun set di risultati. Inoltre, non supporta le macro e le stored procedure in JDBC. È possibile creare macro Teradata con la seguente sintassi: create macro <macro_name> as (select * from <table_name>;); Per ulteriori informazioni, consultare la documentazione relativa a Teradata. Esempio: Macro semplice: create macro GUEST95 as (select * from guest where TYear='FY95';); Macro con un parametro: create macro MGUESTIN (inyear VARCHAR(12)) as (select * from GUEST where TYear=:inyear;); Macro con più set di risultati: create macro MGUEST as ( select * from guest where TYear='FY95'; select count(*) from guest; ); 4.4 Pool di connessioni Per accedere ai dati, un driver apre una connessione al database. Di seguito sono descritti due metodi che è possibile utilizzare per connettersi a un database: • Se Connection Server richiede informazioni, il driver di accesso ai dati apre una connessione al database, recupera i dati e chiude la connessione. 38 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati • Connection Server mantiene aperte le connessioni disponibili e ne gestisce i dettagli in un pool di connessioni. Se Connection Server richiede informazioni dall'origine dati, il driver di accesso ai dati controlla il pool di connessioni per vedere se contiene una connessione appropriata non utilizzata. Se è disponibile una connessione esistente, viene utilizzata. Se tutte le connessioni sono in uso, Connection Server crea una nuova connessione e la aggiunge al pool. Questo metodo utilizza in modo più efficace le risorse di sistema. Promemoria: Connection Server non aggiunge una connessione che utilizza il Single Sign On al pool. 4.4.1 Informazioni sulle connessioni del pool Le connessioni disponibili nel pool di connessioni possono essere esclusive o condivise. • • Le connessioni esclusive possono essere allocate a un solo utente alla volta. Quando una connessione esclusiva viene allocata, non è più disponibile nel pool. Pertanto, non è possibile assegnarla ad altri richiedenti. Quando la connessione non è più richiesta, il driver personalizzato rilascia la connessione in modo che possa essere riallocata. Le connessioni condivise possono essere allocate a più utenti alla volta. Quando una connessione viene allocata, resta nel pool disponibile anche per gli altri richiedenti. È possibile scegliere di creare una connessione esclusiva o condivisibile con il parametro Modalità Connection Pool della procedura guidata di connessione. Argomenti correlati • Connection Shareable • Shared Connection • Max Pool Time 4.5 Bilanciamento del carico: In modalità server, è possibile eseguire diverse istanze di Connection Server sulla piattaforma BI. Connection Server implementa un meccanismo di bilanciamento del carico in questa modalità di distribuzione. Tale meccanismo consente di selezionare il server migliore in termini di risorse in grado di supportare le nuove richieste del client. Il bilanciamento del carico agevola la gestione delle problematiche di scalabilità aumentando il numero di istanze di server sulla piattaforma BI. 39 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati Avvertenza: Tale meccanismo è differente dal bilanciamento del carico implementato dal Central Management Server. Il bilanciamento del carico viene eseguito ai seguenti livelli: • • proxy client in una distribuzione 2-tier, sul livello client bridge del server in una distribuzione di livello Web, sul livello Web Connection Server fornisce inoltre un meccanismo di ricerca a livello di applicazione che consente di selezionare l'istanza di server adeguata per un processo. Connection Server collega il client al server appropriato, in base al tipo di origine dati richiesto dal client e al livello di rete e coppia di database supportati dal server. Promemoria: Il bilanciamento del carico viene eseguito dopo la ricerca ed è disponibile su tutte le piattaforme. 4.5.1 Ricerca del server migliore I problemi di scalabilità del Connection Server possono essere dovuti alle cause seguenti: • Il numero di connessioni di database aperte I problemi relativi al numero di connessioni di database sono già gestiti dal meccanismo di Connection Pool. • La CPU utilizzata dal Connection Server Il Connection Server potrebbe utilizzare una quantità considerevole di CPU durante la conversione dei dati o la scrittura e il reinvio di grandi buffer di risposta al client. Connection Server non fa tuttavia abitualmente un uso intensivo della CPU. • Il numero di processi in esecuzione Il numero di processi in esecuzione su un server ne aumenta il carico di lavoro. • La quantità di memoria allocata dal Connection Server o dal middleware in esso integrato La quantità di memoria utilizzata dipende dalle query SQL eseguite. Ad esempio, una sola istruzione SQL in una tabella di grandi dimensioni potrebbe avere un impatto maggiore sulla scalabilità rispetto a una serie di piccole query SQL. Il Connection Server implementa il bilanciamento del carico con l'aiuto dell'indicatore maggiormente pertinente di carico sul server, che è, in questo caso, la quantità di memoria allocata. Meno memoria viene utilizzata dal Connection Server, migliore ne è lo stato. Nota: nelle versioni future, il Connection Server potrebbe anche prendere il numero di processi come indicatozione dello stato. 40 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati La formula seguente calcola lo stato (HEALTH) del server: HEALTH = (available memory / max memory) * constant laddove: • • • max memory è la quantità massima di memoria allocabile, ad esempio 2 GB su una piattaforma Windows a 32 bit; available memory è la differenza tra max memory e la quantità di memoria attualmente allocata; constant è lo stato massimo (fissato a 10000 per il Connection Server). 4.5.2 Logica del bilanciamento del carico 1. Ogni server candidato segnala il proprio stato all'indicatore di bilanciamento del carico. Un server candidato è un Connection Server che supporta il livello di rete e la coppia di database necessari. Supponendo che tutte le istanze di server supportino lo stesso insieme di origini dati, sono tutte candidate potenziali per soddisfare una richiesta del client. 2. L'indicatore di bilanciamento del carico stabilisce a quale server inviare la richiesta del client individuando e classificando i server maggiormente integri. Identifica quindi il server migliore tra questi. Se l'insieme di server contiene un solo server, sarà quello il server di destinazione. Lo stato viene aggiornato nel corso del ciclo di vita del server. Viene ricalcolato quando si effettua una delle operazioni seguenti: • • • viene creato o distrutto un processo viene preparato o eseguito un processo viene eseguita un'operazione di recupero dati 4.5.3 Compatibilità con le versioni precedenti Il meccanismo di bilanciamento del carico è supportato su tutte le piattaforme a partire dalla versione della piattaforma SAP BusinessObjects Business Intelligence 4.0 Feature Pack 3. In caso di distribuzioni incrementali o di aggiornamenti di versione limitati sulle versioni precedenti, è supportata la compatibilità con le versioni precedenti. Tutti i server che non segnalano il proprio stato all'indicatore di bilanciamento del carico sono considerati integri, ovvero al massimo del proprio stato. Nota: il bilanciamento del carico è disponibile anche per alcune piattaforme in alcuni Service Pack di versioni precedenti. Per ulteriori informazioni, contattare il proprio rappresentante SAP. 41 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati 4.6 Allocazione di memoria Il servizio di connettività nativo può utilizzare la funzionalità di allocazione di memoria HOARD su MS Windows a 64 bit. HOARD è un allocatore di memoria ottimizzato e scalabile per componenti C++ che consentono al servizio di avere prestazioni e scalabilità migliori e una minore frammentazione di memoria. Il livello di accesso ai dati offre i seguenti file binari: • • ConnectionServer.exe, il file binario di default. HOARD non è abilitato. ConnectionServerOptimized.exe, il file binario abilitato per HOARD 4.6.1 Abilitazione di HOARD 1. Aprire la CMC. 2. In "Servizi di connettività", arrestare il Servizio di connettività nativo ospitato dal server ConnectionServer. 3. Localizzare il file eseguibile di Connection Server. Si trova nella directory dir-installazione-bip\win64_x64. 4. Eseguire una copia di backup del file ConnectionServer.exe. 5. Rinominare ConnectionServerOptimized.exe in ConnectionServer.exe. 6. Riavviare il servizio. HOARD è abilitato nel servizio di connettività nativo. 4.6.2 Disabilitazione di HOARD 1. Aprire la CMC. 2. In "Servizi di connettività", arrestare il Servizio di connettività nativo ospitato dal server ConnectionServer. 3. Ripristinare il file predefinito ConnectionServer.exe. 4. Riavviare il servizio da CMC. HOARD è disabilitato nel servizio di connettività nativo. 42 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati 4.7 Attività nella workstation CA Wily Introscope L'attività del flusso di lavoro che comporta l'utilizzo di Connection Server viene analizzata nella workstation CA Wily Interscope. Le funzioni di Connection Server possono essere analizzate tramite le diverse viste proposte dallo strumento indicate di seguito: • • • Cruscotto e vista riepilogativa per le informazioni generali Vista di monitoraggio, in cui gli errori vengono evidenziati e descritti con messaggi Vista ad albero, in cui vengono visualizzate le successive chiamate di funzione di un flusso di lavoro specifico e il tempo utilizzato da una funzione viene evidenziato in modo da individuare facilmente le attività che richiedono più tempo Per ulteriori informazioni, consultare il Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. Argomenti correlati • Configurazione di Java Virtual Machine per la strumentazione 43 2013-07-02 Informazioni sulle caratteristiche specifiche dell'accesso ai dati 44 2013-07-02 Creazione di una connessione Creazione di una connessione 5.1 Requisiti di connessione In questa sezione sono illustrati i requisiti per la creazione di una connessione. • Verificare che la piattaforma in uso sia del tipo supportato per le connessioni SAP. • Verificare che il middleware del database sia installato correttamente e di essere in grado di accedere al database tramite il computer o un server. • Verificare di essere in possesso di tutte le informazioni necessarie per accedere al database, ad esempio il nome di accesso e la password per il database. • Installare la soluzione SAP BusinessObjects da utilizzare, incluso il driver di accesso ai dati appropriato. • Verificare che tutti i servizi siano stati avviati correttamente. • Fare riferimento al documento Leggimi accluso alla soluzione SAP BusinessObjects per verificare se l'ambiente e il software in uso richiedono modifiche della configurazione. • Fare riferimento alle note sulla versione relative all'accesso ai dati per cercare eventuali modifiche alla configurazione che potrebbero influire sull'ambiente in uso. Nota: è possibile utilizzare lo strumento cscheck per controllare l'infrastruttura e determinare se è adatta per l'utilizzo con le applicazioni SAP BusinessObjects. Argomenti correlati • Controllo della configurazione delle connessioni 5.2 Controllo della configurazione delle connessioni Il software Connection Server include una utilità della riga di comando che è possibile utilizzare per controllare l'infrastruttura delle connessioni alle origini dati. È possibile utilizzare lo strumento cscheck per controllare in qualsiasi momento il middleware dei client e i driver di accesso ai dati. 45 2013-07-02 Creazione di una connessione Nota: i risultati dei controlli eseguiti sono validi per il computer locale, dal quale viene eseguito lo strumento. Lo strumento cscheck è installato in dir-installaz-boe\dir_piattaforma dove dir-instal laz-boe è la directory di installazione di BOE e dir_piattaforma rappresenta win32x_86, win64_x64 e così via. Per eseguire lo strumento cscheck, è necessario utilizzare una console dei comandi (DOS o Shell). L'output viene visualizzato sullo schermo. È possibile reindirizzare l'output in un file in formato XML oppure sopprimere l'output per utilizzare lo strumento in uno script. Con lo strumento cscheck è possibile eseguire le funzioni seguenti sul computer locale: • restituire i dettagli di tutte le connessioni, ovvero i livelli di rete e i database che l'installazione è in grado di supportare • restituire i dettagli dei driver di accesso ai dati installati sul computer locale • restituire i dettagli delle connessioni installate sul computer locale • verificare la validità dell'installazione del middleware per un livello di rete e un client di database specifici • verificare la validità dell'installazione dei driver di accesso ai dati per un livello di rete e un client di database specifici • verificare se è possibile stabilire una connessione a un database specifico Argomenti correlati • Strumento di controllo - Panoramica della funzione 5.2.1 Visualizzazione della guida relativa allo strumento cscheck Lo strumento cscheck fornisce la funzionalità necessaria per effettuare le seguenti operazioni: • visualizzare la guida generale relativa all'utilità cscheck • visualizzare la guida relativa a ciascuna funzione disponibile in cscheck La guida può essere visualizzata in qualsiasi lingua selezionata al momento dell'installazione della soluzione SAP BusinessObjects. Per visualizzare la guida generale dello strumento cscheck, utilizzare la sintassi seguente: Figura 5 - 1: Sintassi per visualizzare la guida del comando cscheck 46 --help|h --language|l { lingua } 2013-07-02 Creazione di una connessione Per visualizzare la guida di una funzione, utilizzare la sintassi seguente, dove nomefunzione è il nome della funzione di cui si desidera visualizzare la guida e lingua è la lingua in cui si desidera visualizzare la guida: Figura 5 - 2: Sintassi per visualizzare la guida della funzione cscheck --help|h { nomefunzione }--language|l { lingua } Esempio: Per visualizzare la guida in inglese dello strumento cscheck, utilizzare il comando seguente: cscheck --help Per visualizzare la guida in francese relativa alla funzione connectivity, utilizzare il comando seguente: cscheck --language fr --help connectivity 5.2.2 Esecuzione dello strumento cscheck È possibile eseguire lo strumento cscheck in qualsiasi momento dopo avere installato la soluzione SAP BusinessObjects. 1. Aprire una console dei comandi. 2. Passare alla directory in cui è installato lo strumento. 3. Immettere cscheck con i parametri corretti per trovare le informazioni desiderate. 4. Visualizzare le informazioni restituite. Argomenti correlati • Strumento di controllo - Panoramica della funzione 5.2.3 Strumento di controllo - Panoramica della funzione Da una console dei comandi, utilizzare il comando cscheck con la funzione e gli argomenti appropriati per restituire i risultati desiderati. Il comando cscheck ha la struttura seguente. Alcuni dei parametri sono facoltativi. Figura 5 - 3: sintassi del comando cscheck cscheck --language|l { lingua output } --xml|x --mute|m nome funzione opzioni funzione La prima parte del comando controlla il formato dell'output: 47 2013-07-02 Creazione di una connessione • lingua output o l seguito dalla lingua specificata nello standard ISO639-1. Questa operazione è facoltativa. La lingua predefinita è l'inglese. • --xml oppure x specifica che l'output è in formato XML. Questa operazione è facoltativa. Per impostazione predefinita, l'output è in formato testo visualizzato sullo schermo. • --mute specifica che non deve essere generato alcun output. Utilizzare questo parametro se lo strumento viene utilizzato in uno script per controllare lo stato restituito. Questa operazione è facoltativa. Per impostazione predefinita, l'output viene generato. La parte rimanente del comando è costituita dalla funzione e dai relativi argomenti. nome funzione può assumere i valori di seguito. Ciascuna funzione prevede una sintassi breve che può essere utilizzata al posto del nome completo della funzione: • list o lt • driverssearch o ds • find o fd • middleware o mw • accessdriver o ad • connectivity o ct • ping o pg Argomenti correlati • Strumento cscheck - accessdriver • Strumento cscheck - connectivity • Strumento cscheck - driverssearch • Strumento cscheck - find • Strumento cscheck - list • Strumento cscheck - middleware • Strumento cscheck - ping 5.2.4 Strumento cscheck - list Questa funzione restituisce un elenco dei livelli di rete e moduli di gestione del database supportati. Ad esempio, è possibile utilizzare questa funzione per determinare i valori corretti da utilizzare con le altre funzioni dello strumento cscheck. 48 2013-07-02 Creazione di una connessione Nota: Questa funzione restituisce l'elenco completo dei driver di accesso ai dati e middleware supportati, inclusi quelli che non devono essere necessariamente installati sul computer. Figura 5 - 4: Sintassi della funzione list cscheck |list||lt| Esempio: Il comando seguente elenca tutti i livelli di rete e i motori di database supportati dalla soluzione SAP BusinessObjects installata sul computer corrente. cscheck list Di seguito viene riportato un estratto dell'elenco dei risultati. Oracle Client Oracle 10 Oracle 11 Sybase Open Client Sybase Adaptive Server 15.5 Informix ODBC Driver Informix Dynamic Server 11 Teradata ODBC Driver Teradata 12 Teradata 13 Teradata 14 ODBC Drivers Generic ODBC Datasource Generic ODBC3 Datasource ... Argomenti correlati • Strumento di controllo - Panoramica della funzione • Visualizzazione della guida relativa allo strumento cscheck 5.2.5 Strumento cscheck - driverssearch Questa funzione restituisce un elenco dei driver di accesso ai dati installati. Figura 5 - 5: Sintassi della funzione driverssearch cscheck |driverssearch||ds| Esempio: Il comando seguente elenca tutti i driver di accesso ai dati installati sul computer. cscheck driverssearch 49 2013-07-02 Creazione di una connessione Di seguito viene riportato un estratto dell'elenco dei risultati. This access driver is installed: Oracle OCI access driver Client layer: Oracle Client Database engine(s): Oracle 10 Oracle 11 This access driver is installed: Sybase Open Client access driver Client layer: Sybase Open Client Database engine(s): Sybase Adaptive Server 15.5 This access driver is installed: Informix ODBC access driver Client layer: Informix ODBC Driver Database engine(s): Informix Dynamic Server 11 This access driver is installed: Teradata ODBC access driver Client layer: Teradata ODBC Driver Database engine(s): Teradata 12 Teradata 13 Teradata 14 ... Argomenti correlati • Strumento di controllo - Panoramica della funzione • Visualizzazione della guida relativa allo strumento cscheck 5.2.6 Strumento cscheck - find Questa funzione elenca i tipi di connettività disponibili, ovvero i middleware e i client di database a cui è possibile accedere dal computer locale. Le operazioni richieste sono: • tipi di connettività disponibili sul computer locale • tipi di connettività disponibili utilizzando il livello di comunicazione CORBA • tipi di connettività disponibili utilizzando il livello di comunicazione HTTP • Tipi di connettività Java disponibili sul computer locale Figura 5 - 6: Sintassi della funzione find cscheck |find||fd| -m { modalità di accesso Connection Server } 50 2013-07-02 Creazione di una connessione Tabella 5 - 1: Parametri di input della funzione La modalità con cui l'applicazione client accede a Connection Server: • local: elenca i tipi di connettività disponibili sul computer locale. Modalità di accesso Connection Server (-m) • corba: elenca i tipi di connettività disponibili utilizzando CORBA. • http: elenca i tipi di connettività disponibili utilizzando HTTP. • java: elenca i tipi di connettività Java disponibili sul computer locale. • extended: elenca i tipi di connettività local, java e CORBA. Esempio: Ricerca dei tipi di connettività locali Il comando seguente restituisce un elenco dei driver di accesso ai dati sul computer locale che possono essere caricati dal Connection Server. cscheck find –m local Di seguito viene riportato un estratto dell'elenco dei risultati. Local Library Mode IBM DB2 Client DB2 10 for LUW DB2 10 for z/OS DB2 for i v6 DB2 for i v7 DB2 for z/OS v9 DB2 UDB for iSeries v5 DB2 v9 Essbase Provider Hyperion Essbase 7 Hyperion Essbase 9 Informix ODBC Driver Informix Dynamic Server 11 ODBC Drivers Generic ODBC datasource Generic ODBC3 datasource MS SQL Server 2008 MS SQL Server 2012 Sybase SQL Anywhere 10 ... Esempio: Ricerca dei tipi di connettività al server CORBA Il comando seguente restituisce un elenco dei driver di accesso ai dati disponibili da un server CORBA. cscheck find –m corba 51 2013-07-02 Creazione di una connessione Argomenti correlati • Strumento di controllo - Panoramica della funzione • Visualizzazione della guida relativa allo strumento cscheck 5.2.7 Strumento cscheck - middleware Per un livello di rete e un client di database forniti, questa funzione ricerca un'installazione valida di un middleware client. Per controllare il middleware e il driver di accesso ai dati per un livello di rete e un client di database forniti, è possibile utilizzare la funzione connectivity. Figura 5 - 7: Sintassi della funzione middleware cscheck |middleware| |mw| -c { livello di rete } -d { cliente di database } Tabella 5 - 2: Parametri di input della funzione livello di rete (-c) Il livello di rete utilizzato dal middleware del database, restituito dalla funzione find. client di database (-d) Il database da controllare, restituito dalla funzione find. Esempio: Il comando seguente verifica la presenza di un'installazione valida del middleware Oracle Client 10g sul computer locale. Crea un file di output in formato XML: c:\result.xml cscheck --xml middleware -c "Oracle Client" -d "Oracle 9" > c:\result.xml Se il middleware non è installato correttamente, il risultato sarà il seguente: Starting to check the middleware component installation... Begin AND operator... ORACLE_HOME... The environment setting does not exist. End AND operator: failure. The middleware is not correctly installed. Argomenti correlati • Strumento di controllo - Panoramica della funzione • Visualizzazione della guida relativa allo strumento cscheck • Strumento cscheck - connectivity • Strumento cscheck - accessdriver 52 2013-07-02 Creazione di una connessione 5.2.8 Strumento cscheck - accessdriver Per un livello di rete e un client di database forniti, questa funzione ricerca un'installazione valida di un driver di accesso ai dati. Per controllare il middleware e il driver di accesso ai dati per un livello di rete e un client di database forniti, è possibile utilizzare la funzione connectivity. Figura 5 - 8: Sintassi della funzione accessdriver cscheck |accessdriver| |ad| -c { livello di rete } -d { cliente di database } Tabella 5 - 3: Parametri di input della funzione livello di rete ( -c ) Il livello di rete utilizzato dal middleware del database, restituito dalla funzione find. client di database (-d) Il database da controllare, restituito dalla funzione find. Esempio: Il comando seguente ricerca un'installazione valida di un driver di accesso ai dati Oracle 10 e visualizza l'output in lingua francese: cscheck -l fr accessdriver -c "Oracle Client" -d "Oracle 10" Se la lingua francese non è installata, il risultato sarà il seguente: The language specified is not installed. Please use an installed language. English ([en]). Esempio: Il comando seguente verifica la presenza di un'installazione valida del driver di accesso ai dati Oracle 10: cscheck ad -c "Oracle Client" -d "Oracle 10" Il risultato è il seguente: Starting to check the access driver component installation... Begin AND operator... Config Directory... success. %SharedRoot%\ConnectionServer\Network Layers\Oracle OCI... success. Directory... success. /connectionserver-install-dir/connectionServer//oracle... success. Library... success. /connectionserver-install-dir/connectionServer//libdbd_oci10.so... success. /connectionserver-install-dir/connectionServer//libdbd_oci11.so... success. Data File Name... success. 53 2013-07-02 Creazione di una connessione /connectionserver-install-dir/connectionServer//oracle/oracle.sbo... success. End AND operator: success. The access driver is installed. Argomenti correlati • Strumento di controllo - Panoramica della funzione • Visualizzazione della guida relativa allo strumento cscheck • Strumento cscheck - list 5.2.9 Strumento cscheck - connectivity Per il livello di rete e il client di database forniti, questa funzione controlla se il middleware e i driver di accesso ai dati siano entrambi validi. È possibile controllare questi elementi singolarmente utilizzando le funzioni middleware e access driver. È possibile utilizzare la funzione ping per controllare se è possibile stabilire la connessione a un database specifico. Figura 5 - 9: Sintassi della funzione connectivity cscheck |connectivity| |ct| -c { livello di rete } -d { cliente di database } Tabella 5 - 4: Parametri di input della funzione livello di rete (-c) Il livello di rete utilizzato dal middleware del database, restituito dalla funzione find. client di database (-d) Il database da controllare, restituito dalla funzione find. Esempio: Il comando seguente controlla il middleware del client Oracle installato e il driver di accesso ai dati Oracle 10. Il comando scrive l'output in un file di testo: c:\result.txt . cscheck -l en connectivity -c "Oracle Client" -d "Oracle 10">c:\result.txt Se il middleware non è installato correttamente, il risultato sarà il seguente: Starting to check the middleware component installation... Begin AND operator... ORACLE_HOME... The environment setting does not exist. End AND operator: failure. The middleware is not correctly installed. 54 2013-07-02 Creazione di una connessione Starting to check the access driver component installation... Begin AND operator... Config Directory... success. %SharedRoot%\ConnectionServer\Network Layers\Oracle OCI... success. Directory... success. /connectionserver-install-dir/connectionServer//oracle... success. Library... success. /connectionserver-install-dir/connectionServer//libdbd_oci10.so... success. /connectionserver-install-dir/connectionServer//libdbd_oci11.so... success. Data File Name... success. /connectionserver-install-dir/connectionServer//oracle/oracle.sbo... success. End AND operator: success. The access driver is installed. Argomenti correlati • Strumento di controllo - Panoramica della funzione • Visualizzazione della guida relativa allo strumento cscheck • Strumento cscheck - find • Strumento cscheck - accessdriver • Strumento cscheck - middleware • Strumento cscheck - ping 5.2.10 Strumento cscheck - ping Questa funzione tenta di accedere a un database specifico utilizzando i dettagli forniti. Figura 5 - 10: Sintassi della funzione ping cscheck ping|pg| -m { modalità di accesso Connection Server } -c { livello di rete } -d { cliente di database } -u { nome utente } -p { password } -s { origine dati } -t { database } -r { nome host } -j { PID } Tabella 5 - 5: Parametri di input della funzione La modalità con cui l'applicazione client accede a Connection Server: • local: Connection Server è in esecuzione sul computer locale. • corba: Connection Server è in esecuzione su un server CORBA. • http: Connection Server è in esecuzione su un server HTTP. • java: Connection Server utilizza un driver di accesso ai dati Java sul computer locale. Modalità di accesso Connection Server (-m) 55 2013-07-02 Creazione di una connessione livello di rete (-c) La connessione al middleware del database da controllare, restituita dalla funzione find. client di database (-d) Il tipo di database, restituito dalla funzione find. nome utente (-u) Un nome utente valido per il database. password (-p) La password associata al nome utente. origine dati (-s) Il server in cui è in esecuzione il database. database (-t) Il server di database. nome host (-r) Per la modalità CORBA, il computer in cui risiede Connection Server. PID (-i) Per la modalità CORBA, il numero di processo del Connection Server a cui eseguire il ping. Esempio: Ping a un database Oracle Il comando seguente controlla l'accesso per: • Modalità di accesso Connection Server: local, ovvero il database viene eseguito sul computer locale. • Livello di rete: Oracle Client • Database: Oracle 10g • Origine dati: Harlaxton • Nome utente: efashion • Password: X2345 cscheck ping -m local -c "Oracle Client" -d "Oracle 10" -u "efashion" -p "X2345" -s "Harlaxton" Esempio: Ping a un database Sybase utilizzando CORBA Il comando seguente controlla l'accesso per: 56 2013-07-02 Creazione di una connessione • Modalità di accesso Connection Server: CORBA, ovvero Connection Server viene eseguito su un server CORBA. • Livello di rete: Sybase • Nome utente: syadmin • Password: password • Origine dati: Sybase Adaptive Server 15 • Database: SY1 • Host database: sybasehost • ID processo: 456 cscheck ping -m corba -c "Sybase Open Client" -d syb15 -u "syadmin" -p "password" -s "Sybase Adaptive Server 15.5" -t "SY1" -r "sybasehost" -i 456 Argomenti correlati • Strumento di controllo - Panoramica della funzione • Strumento cscheck - find 5.3 Creazione di connessioni JDBC Un insieme di driver di accesso ai dati viene installato al momento dell'installazione della piattaforma BI. È possibile utilizzare i driver di accesso ai dati per creare connessioni ai database. I driver si trovano nella directory dir-installazione-connectionserver\connectionServer\drivers\java. Nota: la connettività JDBC è disponibile per SAP BusinessObjects Enterprise XI 3.0 e versioni successive. Web Intelligence Rich Client supporta la connettività JDBC in modalità 3-tier nella piattaforma SAP BusinessObjects Business Intelligence 4.0 e versioni successive. Il software SAP BusinessObjects include anche i file di configurazione richiesti per utilizzare i driver JDBC per l'accesso ai database. Per utilizzare questi driver, effettuare quanto riportato di seguito: 1. Ottenere il software dei driver Java dal fornitore di database. 2. Specificare i percorsi dei file JAR seguendo una di queste procedure: • Impostare l'elemento ClassPath nel file di configurazione SBO del driver di accesso ai dati con il percorso completo del file JAR. • Salvare i file JAR nelle directory create utilizzando i valori dei parametri della sezione Extensions del file SBO. 57 2013-07-02 Creazione di una connessione Le due procedure possono essere utilizzate contemporaneamente per specificare i percorsi dei file JAR. Tuttavia, i file JAR specificati nel file SBO hanno la precedenza sui file JAR archiviati nelle directory dell'utente. Nota: SAP Visual Intelligence consente agli utenti di selezionare file JAR direttamente dalla casella di creazione delle connessioni dell'applicazione. Per ulteriori informazioni, consultare il Manuale dell'utente di Visual Intelligence. Per un elenco aggiornato dei driver JDBC supportati, visitare il SAP Service Marketplace all'indirizzo http://service.sap.com/bosap-support o contattare il rappresentante SAP di fiducia. Nota: il livello di accesso ai dati fornisce le connessioni JDBC generiche al fine di creare una connessione a un'origine dati che la piattaforma BI non supporta esplicitamente. Argomenti correlati • Creazione di una connessione JDBC con il file SBO • Creazione di una connessione JDBC con Extensions • Creazione di una connessione JDBC generica • Proprietà del driver JDBC 5.3.1 Creazione di una connessione JDBC con il file SBO • Ottenere il software dei driver JDBC necessari per il database e copiare i file nel sistema. Questi file sono disponibili dal fornitore del database. Il software dei driver in genere è costituito da uno o più file .jar. Annotare i dettagli del percorso di installazione per questi file. • Verificare di disporre dei dettagli di accesso al database, ad esempio dettagli di connessione e password. 1. Selezionare la directory che contiene il file SBO da utilizzare. Ad esempio, in Microsoft Windows, i file di configurazione JDBC si trovano nella directory dir-in stallazione-connectionserver\connectionServer\jdbc. 2. Utilizzare un editor XML per aprire il file SBO da modificare. 3. Aggiungere i dettagli del file .jar all'area ClassPath. Includere i nomi di percorso completi quando si specificano questi file, ad esempio: <Path>C:\\JDBC Drivers\\MSSQLSERVER2008\\msutil.jar</Path> Nota: Questi file devono essere installati sul computer che esegue l'applicazione. 4. Individuare il parametro Driver Capabilities e verificare che sia impostato su Procedure, Queries o entrambi. 58 2013-07-02 Creazione di una connessione Nota: Nell'ultimo caso, le impostazioni sono separate da una virgola. Avvertenza: Se non è impostato su uno di questi valori, il driver JDBC non sarà disponibile dalla procedura guidata di connessione. 5. Salvare e chiudere il file SBO. 6. Eseguire la procedura guidata di connessione. Il driver JDBC configurato viene visualizzato nell'elenco delle connessioni disponibili. 7. Selezionare il driver JDBC e utilizzare la procedura guidata per configurare la connessione. Dopo avere completato questa attività, la connessione è disponibile per essere utilizzata. Argomenti correlati • Requisiti di connessione • File di configurazione per l'accesso ai dati 5.3.2 Struttura file di esempio SBO JDBC Segue un esempio della sezione del file sqlsrv.sbo da modificare. Questo file SBO è valido per Microsoft SQL Server 2008. <DataBase Active="Yes" Name="MS SQL Server 2008"> ... <JDBCDriver> <ClassPath> <Path>C:\\JDBC Drivers\\MSSQLSERVER2008\\msbase.jar</Path> <Path>C:\JDBC Drivers\MSSQLSERVER2008\\msutil.jar</Path> <Path>C:\\JDBC Drivers\\MSSQLSERVER2008\\mssqlserver.jar</Path> </ClassPath> ... </JDBCDriver> ... </DataBase> 5.3.3 Creazione di una connessione JDBC con Extensions 59 • Ottenere il software dei driver JDBC necessari per il database e copiare i file nel sistema. Questi file sono disponibili dal fornitore del database. Il software dei driver in genere è costituito da uno o più file JAR. • Verificare di disporre dei dettagli di accesso al database, ad esempio dettagli di connessione e password. 2013-07-02 Creazione di una connessione 1. Andare alla sezione successiva del manuale per trovare i valori del parametro Extensions. 2. Utilizzare uno o più valori dei parametri di Extensions per creare le proprie directory dei driver. Ad esempio, i valori del parametro Extensions per il middleware MS SQL Server 2008 sono sqlsrv2008, sqlsrv e jdbc nel file sqlsrv.sbo. È possibile creare una qualsiasi delle directory seguenti: • dir-installazione-connectionserver\connectionServer\jdbc\drivers\sql srv2008 • dir-installazione-connectionserver\connectionServer\jdbc\drivers\sqlsrv • dir-installazione-connectionserver\connectionServer\jdbc\drivers\jdbc 3. Copiare i file JAR nelle directory prescelte. 4. Eseguire la procedura guidata di connessione. Il driver JDBC configurato viene visualizzato nell'elenco delle connessioni disponibili. 5. Selezionare il driver JDBC e utilizzare la procedura guidata per configurare la connessione. Per caricare i driver JDBC, Connection Server cerca i file JAR in ciascuna directory, dalla più specifica alla meno specifica, finché non li trova. La connessione è disponibile per l'utilizzo. Esempio: Ad esempio, se si salvano i file JAR solo in dir-installazione-connectionserver\connec tionServer\jdbc\drivers\sqlsrv, Connection Server prima esegue la ricerca dei driver nella directory sqlsrv2008, la trova vuota, quindi esegue la ricerca nella directory sqlsrv, trova i file JAR e carica il driver. Nota: Poiché sqlsrv è il valore di Extensions per tutti i database MS SQL Server di destinazione, i file JAR specificati in questa directory vengono caricati per tutti i database MS SQL Server. Argomenti correlati • Creazione di una connessione JDBC con il file SBO • File di configurazione per l'accesso ai dati 5.3.4 Riferimento per la posizione del file JAR Nella tabella seguente sono indicati i nomi delle cartelle in cui posizionare i file JAR middleware per abilitare le connessioni JDBC. Nella prima colonna sono elencati i nomi dei fornitori di database come mostrati nella procedura guidata di connessione. Nella seconda colonna sono elencati i nomi dei database che supportano le connessioni JDBC, come descritto nella sezione DataBase del file SBO corrispondente. Nella terza colonna sono elencati i nomi delle cartelle che possono essere create, come descritto dai valori del parametro Extensions del file SBO. 60 2013-07-02 Creazione di una connessione Il parametro Extensions è un elemento secondario dell'elemento DataBase che corrisponde al middleware del database di destinazione nei file SBO. Se l'elemento non è si trova in DataBase, significa che il valore del parametro è valido per tutto il middleware configurato nel file SBO. Quindi fare riferimento alla sezione Defaults del file. In Microsoft Windows, i file di configurazione JDBC si trovano nella directory dir-installazione-connectionserver\connectionServer\jdbc. Nota: I driver Data Federator JDBC vengono installati come parte della piattaforma BI nella directory dirinstallazione-connectionserver\connectionServer\jdbc\drivers\datafederator. I driver JDBC SAP HANA 1.0 SPS 05 vengono installati nella directory dir-installazione-conne ctionserver\connectionServer\jdbc\drivers\newdb. Di conseguenza, non è necessario eseguire operazioni di configurazione aggiuntive per creare una connessione al server delle query di Data Federator XI 3.0 o al database SAP HANA. Fornitore Database Valori del parametro Extensions Derby 10 incorporato derby10, derby, jdbc Apache Hadoop HIVE apache, hive, jdbc Amazon EMR HIVE amazon, hive, jdbc PostgreSQL 8 postgresql8, postgresql, jdbc GreenPlum4, PostgreSQL 9 postgresql9, postgresql, jdbc Hewlett Packard HP Neoview neoview, jdbc HSQLDB HSQLDB 1.8 incorporato hsqldb18, hsqldb, jdbc DB2 v9 db2v9, db2udb, db2, jdbc DB2 10 for z/OS db2mvs10, db2mvs, db2, jdbc DB2 10 for LUW db2v10, db2udb, db2, jdbc Informix Dynamic Server 11 ids11, informix, jdbc Ingres Database 9 ingres9, ingres, jdbc Apache Greenplum IBM Ingres 61 2013-07-02 Creazione di una connessione Fornitore Database Valori del parametro Extensions MS SQL Server 2008 sqlsrv2008, sqlsrv, jdbc MS SQL Server 2012 sqlsrv2012, sqlsrv, jdbc Netezza Server 4 netezza4, netezza, jdbc Netezza Server 5 netezza5, netezza, jdbc Netezza Server 6 netezza6, netezza, jdbc MySQL 5 mysql5, mysql, jdbc Oracle 10 oracle10, oracle, jdbc Oracle 11 oracle11, oracle, jdbc Oracle Exadata oracleexadata, oracle11, oracle, jdbc Data Federator XI R3 datafederator3, datafederator, jdbc Data Federator XI R4 datafederator4, datafederator, jdbc MaxDB 7.7 maxdb7.7, maxdb, jdbc Database SAP HANA 1.0 newdb, jdbc Sybase Adaptive Server Enterprise 15.5 sybase15, sybase, jdbc Sybase IQ 15 iq15, asiq, jdbc Sybase SQL Anywhere 11 ssa11, ssa, jdbc Sybase SQL Anywhere 12 ssa12, ssa, jdbc Microsoft Netezza Oracle SAP Sybase 62 2013-07-02 Creazione di una connessione Fornitore Teradata Database Valori del parametro Extensions Teradata 12 teradata12, teradata, jdbc Teradata 13 teradata13, teradata, jdbc Teradata 14 teradata14, teradata, jdbc Argomenti correlati • Connessioni SAP HANA • Informazioni sulle connessioni al server delle query di Data Federator XI 3.0 5.3.5 Creazione di una connessione JDBC generica • Ottenere il software dei driver JDBC necessari per il database. Il file .jar deve essere installato sul computer che esegue l'applicazione SAP BusinessObjects. • Verificare di disporre dei dettagli di accesso al database, ad esempio dettagli di connessione e password. 1. Accedere alla directory che contiene il file jdbc.sbo e jdbc.prm. Ad esempio, in Microsoft Windows, i file di configurazione si trovano nella directory dir-instal lazione-connectionserver\connectionServer\jdbc. 2. Copiare il file .jar necessario nella directory dir-installazione-connectionserver\co nnectionServer\jdbc\drivers\jdbc. È necessario creare la directory se non esiste. 3. Eseguire la procedura guidata di connessione. Il driver JDBC viene visualizzato nell'elenco delle connessioni disponibili in Generico. 4. Selezionare il driver JDBC e utilizzare la procedura guidata per configurare la connessione con i dettagli seguenti: • URL JDBC • Classe JDBC • nome utente • password Dopo avere completato questa attività, la connessione all'origine dati è disponibile per essere utilizzata tramite JDBC. 63 2013-07-02 Creazione di una connessione Nota: il file jdbc.prm contiene solo informazioni sulle funzioni generiche di un database JDBC. È possibile aggiungere o aggiornare le informazioni specifiche in un database personalizzato nel file. Le modifiche al file jdbc.prm si applicano a tutte le connessioni JDBC generiche create o da creare. Argomenti correlati • File di configurazione per l'accesso ai dati • Informazioni sui file PRM 5.4 Creazione di connessioni JavaBean Un driver di accesso ai dati che utilizza un JavaBean viene installato quando si installa la piattaforma BI. Si trova nella directory dir-installazione-connectionserver\connectionServer\dri vers\java. Gli sviluppatori possono creare JavaBean che forniscono l'accesso alle origini dati. È possibile creare connessioni tramite questi JavaBean. Per creare una connessione JavaBean, gli sviluppatori che creano il codice JavaBean forniranno le seguenti informazioni: • i file JAR necessari • qualsiasi altro file richiesto da JavaBean • tutti i dettagli di configurazione specifici richiesti dal driver JavaBean Come per le connessioni JDBC, è inoltre possibile creare una connessione JavaBean utilizzando la funzionalità Extensions. Nota: In un driver JavaBean, le procedure di recupero dei dati sono configurate come stored procedure. Quando si crea una connessione JavaBean con la procedura guidata di connessione, è necessario selezionare Filtra livello di rete stored procedure nella schermata Selezione del middleware del database. In caso contrario, la procedura guidata di connessione non visualizzerà i driver JavaBean disponibili. Argomenti correlati • Creazione di connessioni JDBC • Creazione di una connessione JavaBean • Creazione di una connessione JavaBean con Extensions 64 2013-07-02 Creazione di una connessione 5.4.1 Creazione di una connessione JavaBean 1. Utilizzare un editor XML per aprire il file javabean.sbo da modificare. Ad esempio, in Microsoft Windows, i file di configurazione si trovano nella directory dir-instal lazione-connectionserver\connectionServer\javabean. 2. Aggiungere i dettagli del file .jar all'area ClassPath. Includere i nomi di percorso completi quando si specificano questi file. Nota: Questi file devono essere installati sul computer che esegue l'applicazione SAP BusinessObjects. Per i dettagli, consultare le informazioni contenute nella struttura del file javabean.sbo di esempio. 3. Salvare e chiudere il file. 4. Eseguire le altre attività di configurazione specificate dallo sviluppatore JavaBean. 5. Eseguire la procedura guidata di connessione. L'origine dati JavaBean configurata dovrebbe essere visualizzata nell'elenco delle connessioni disponibili. 6. Selezionare l'origine dati JavaBean e utilizzare la procedura guidata per configurare la connessione. Dopo avere completato questa attività, la connessione è disponibile per essere utilizzata con un'applicazione. Argomenti correlati • File di configurazione per l'accesso ai dati 5.4.2 Struttura file di esempio SBO JavaBean Questa sezione contiene un esempio di file SBO JavaBean. <DataBase Active="Yes" Name="Excel Spreadsheet"> <JavaBean> <ClassPath> <Path>$ROOT$\\beans\\bean_excel.jar</Path> </ClassPath> <Parameter Name="JavaBean Class">com.businessobjects.beans.excel.Excel</Parameter> <Parameter Name="URL Format">$DATASOURCE$</Parameter> </JavaBean> <Parameter Name="Family">Java Beans</Parameter> <Parameter Name="Description File">bean_excel</Parameter> <Parameter Name="Authentication Mode">Bypass</Parameter> <Parameter Name="Extensions">bean_excel,javabean</Parameter> </DataBase> </DataBases> 65 2013-07-02 Creazione di una connessione 5.4.3 Creazione di una connessione JavaBean con Extensions 1. Selezionare la directory che contiene il file javabean.sbo. Ad esempio, in Microsoft Windows il file si trova nella directory dir-installazione-connectio nserver\connectionServer\javabean. 2. Aprire il file SBO per visualizzare il contenuto. 3. Individuare l'elemento <Parameter Name="Extensions"> nella sezione Defaults. Nota: Se si sviluppa un driver JavaBean utilizzando il DDK, individuare il parametro Extensions nell'elemento <DataBase Active="Yes" Name="Excel Spreadsheet">. 4. Utilizzare uno o più valori dei parametri di Extensions per creare le proprie directory dei driver. Ad esempio, il valore del parametro Extensions è javabean nella sezione Defaults del file. A questo punto è possibile creare la directory dir-installazione-connectionserver\conne ctionServer\javabean\drivers\javabean. 5. Copiare i file JAR nelle directory prescelte. 6. Chiudere il file SBO. 7. Eseguire la procedura guidata di connessione. Il driver JavaBean configurato viene visualizzato nell'elenco delle connessioni disponibili. 8. Selezionare il driver JavaBean e utilizzare la procedura guidata per configurare la connessione. Per caricare i driver JavaBean, Connection Server cerca i file JAR in ciascuna directory, dalla più specifica alla meno specifica, finché non li trova. La connessione è disponibile per l'utilizzo. Argomenti correlati • Creazione di una connessione JavaBean • File di configurazione per l'accesso ai dati 5.5 Creazione di connessioni ODBC Un insieme di driver di accesso ai dati viene installato al momento dell'installazione della piattaforma BI. È possibile utilizzare i driver di accesso ai dati per creare connessioni ai database. I driver si trovano nella directory dir-installazione-connectionserver\connectionServer\drivers\lib32 o dir-installazione-connectionserver\connectionServer\drivers\lib64. Il software SAP BusinessObjects include anche i file di configurazione richiesti per utilizzare i driver ODBC per l'accesso ai database. Per utilizzare questi driver, effettuare quanto riportato di seguito: 66 2013-07-02 Creazione di una connessione 1. Ottenere il software del driver ODBC dal fornitore di database. 2. Modificare i file di configurazione forniti. La maggior parte dei driver ODBC è disponibile in Unicode e non Unicode. Per un elenco aggiornato dei driver ODBC supportati, visitare il SAP Service Marketplace all'indirizzo http://service.sap.com/bosap-support o contattare il rappresentante SAP di fiducia. Nota: il livello di accesso ai dati fornisce le connessioni ODBC generiche al fine di creare una connessione a un'origine dati che la piattaforma BI non supporta esplicitamente. Informazioni sulle connessioni ODBC generiche in UNIX Il sistema operativo Microsoft Windows viene fornito con una gestione driver ODBC standard. UNIX invece non fornisce alcun metodo standard per la gestione dei driver. Il software SAP BusinessObjects consente di utilizzare sistemi di gestione dei driver DataDirect o unixODBC per le connessioni ODBC generiche in UNIX. Prima di creare una connessione ODBC generica in UNIX per un database generico, è necessario identificare quanto segue: • • la versione del driver ODBC se il driver è in grado di funzionare con il gestore dei driver DataDirect o unixODBC Modificare quindi i file di configurazione forniti e configurare l'origine dati corrispondente per abilitare la connessione. Argomenti correlati • Creazione di una connessione ODBC generica • Creazione di una connessione ODBC3 generica 5.5.1 Creazione di una connessione ODBC generica La procedura seguente mostra come configurare una connessione ODBC generica a un database tenendo presente quanto segue: • Il driver è ODBC2 • il driver supporta la gestione driver unixODBC 1. Accedere alla directory contenente il file odbc.sbo e odbc.prm. I file di configurazione si trovano nella directory dir-installazione-connectionserver/co nnectionServer/odbc. 2. Utilizzare un editor XML per aprire il file odbc.sbo da modificare. 3. Individuare la seguente sezione: <DataBases> <DataBase Active="Yes" Name="Generic ODBC datasource"> <Libraries> 67 2013-07-02 Creazione di una connessione ... <Library Platform="Unix">dbd_wddodbc</Library> <Library Platform="Unix">dbd_ddodbc</Library> <!--Library Platform="Unix">dbd_wuxodbc</Library--> <!--Library Platform="Unix">dbd_uxodbc</Library--> </Libraries> <Parameter Name="Charset Table" Platform="Unix">datadirect</Parameter> ... </DataBases> 4. Aggiungere un commento alle prime due righe di DataDirect e rimuovere il commento da una delle due righe successive. Verificare di aver inserito la riga dalla quale viene rimosso il commento nella parte superiore della sessione, in modo che venga letta prima. Rimuovere il commento dell'elemento <Parameter Name="CharSet Table" Platform="Unix">. Nota: • • • • dbd_wddodbc2 specifica il driver ODBC2 Unicode basato su DataDirect dbd_ddodbc2 specifica il driver ODBC2 non Unicode basato su DataDirect dbd_wuxodbc2 specifica il driver ODBC2 Unicode basato su unixODBC dbd_uxodbc2 specifica il driver ODBC2 non Unicode basato su unixODBC 5. Salvare e chiudere il file odbc.sbo. 6. Utilizzare un editor XML per aprire il file odbc.prm da modificare. 7. Aggiungere o aggiornare le informazioni specifiche del database. Nota: Il file odbc.prm potrebbe non contenere informazioni sulle specifiche funzioni del database. 8. Salvare e chiudere il file odbc.prm. 9. Installare i driver ODBC corrispondenti sul computer UNIX. 10. Configurare l'origine dati modificando il file odbc.ini. 11. Salvare e chiudere il file odbc.ini. 12. Eseguire la procedura guidata di connessione. Il driver ODBC configurato viene visualizzato nell'elenco delle connessioni disponibili in Generico. 13. Selezionare il driver ODBC e utilizzare la procedura guidata per configurare la connessione. Dopo avere completato questa attività, la connessione all'origine dati è disponibile per essere utilizzata tramite ODBC generico con la gestione driver unixODBC. Argomenti correlati • File di configurazione per l'accesso ai dati 5.5.2 Creazione di una connessione ODBC3 generica La procedura seguente mostra come configurare una connessione ODBC generica a un database tenendo presente quanto segue: 68 2013-07-02 Creazione di una connessione • il driver è ODBC3 • il driver supporta la gestione driver unixODBC 1. Accedere alla directory contenente il file odbc.sbo e odbc.prm. I file di configurazione si trovano nella directory dir-installazione-connectionserver/co nnectionServer/odbc. 2. Utilizzare un editor XML per aprire il file odbc.sbo da modificare. 3. Individuare la seguente sezione: <DataBases> <DataBase Active="Yes" Name="Generic ODBC3 datasource"> <Libraries> ... <Library Platform="Unix">dbd_wddodbc3</Library> <Library Platform="Unix">dbd_ddodbc3</Library> <!--Library Platform="Unix">dbd_wuxodbc3</Library--> <!--Library Platform="Unix">dbd_uxodbc3</Library--> <!--Library Platform="Unix64">dbd_wux32odbc3</Library--> <!--Library Platform="Unix64">dbd_ux32odbc3</Library--> </Libraries> <Parameter Name="Charset Table" Platform="Unix">datadirect</Parameter> ... </DataBases> 4. Aggiungere un commento alle prime due righe di DataDirect e rimuovere il commento da una delle quattro righe successive. Verificare di aver inserito la riga dalla quale viene rimosso il commento nella parte superiore della sessione, in modo che venga letta prima. Rimuovere il commento dall'elemento <Parameter name="CharSet Table" Platform="Unix">. Nota: • • • • • • dbd_wddodbc3 specifica il driver ODBC3 Unicode basato su DataDirect dbd_ddodbc3 specifica il driver ODBC3 non Unicode basato su DataDirect dbd_wuxodbc3 specifica il driver ODBC3 Unicode basato su unixODBC dbd_uxodbc3 specifica il driver ODBC3 non Unicode basato su unixODBC dbd_wux32odbc3 specifica il driver ODBC3 Unicode basato su unixODBC con API a 32 bit anziché a 64 bit (disponibile solo su piattaforme a 64 bit) dbd_ux32odbc3 specifica il driver ODBC3 non Unicode basato su unixODBC con API a 32 bit anziché a 64 bit (disponibile solo su piattaforme a 64 bit) 5. Salvare e chiudere il file odbc.sbo. 6. Utilizzare un editor XML per aprire il file odbc.prm da modificare. 7. Aggiungere o aggiornare le informazioni specifiche del database. Nota: Il file odbc.prm potrebbe non contenere informazioni sulle specifiche funzioni del database. 8. Salvare e chiudere il file odbc.prm. 9. Installare i driver ODBC corrispondenti sul computer UNIX. 10. Configurare l'origine dati modificando il file odbc.ini. 11. Salvare e chiudere il file odbc.ini. 12. Eseguire la procedura guidata di connessione. Il driver ODBC configurato viene visualizzato nell'elenco delle connessioni disponibili in Generico. 13. Selezionare il driver ODBC e utilizzare la procedura guidata per configurare la connessione. 69 2013-07-02 Creazione di una connessione Dopo avere completato questa attività, la connessione all'origine dati è disponibile per essere utilizzata tramite ODBC3 con la gestione driver unixODBC. Argomenti correlati • File di configurazione per l'accesso ai dati 70 2013-07-02 Riferimento per i driver di accesso ai dati Riferimento per i driver di accesso ai dati 6.1 Driver di accesso ai dati In questo capitolo vengono fornite informazioni dettagliate su alcuni driver di accesso ai dati, che consentono connessioni alle origini dati mediante documenti OData o XML, e specifici database come i sistemi SAP ERP basati su ABAP. Vengono descritte principalmente le regole di mappatura tra modelli di dati non semplici e il modello relazionale utilizzato nel livello di accesso ai dati. Questo capitolo tratta solo le connessioni da creare in Information Design Tool. Argomenti correlati • CSV OpenDriver • Driver OData • Driver SAP ERP • Driver XML • Driver di servizio Web 6.2 CSV OpenDriver Il livello di accesso ai dati consente alla piattaforma BI di connettersi ai file CSV (Comma-Separated Value) attraverso il livello di rete BusinessObjects OpenConnectivity. Fornisce un driver di accesso ai dati denominato CSV OpenDriver per accedere ai file CSV. La procedura guidata di connessione offre un workflow per l'inserimento delle informazioni necessarie per connettersi ai file CSV. Le origini dati CSV sono presenti in File di testo DBMS e nel livello di rete BusinessObjects OpenConnectivity. Compatibilità con le versioni precedenti La compatibilità con le versioni precedenti tra le versioni SAP BusinessObjects Enterprise XI 3.x e la piattaforma SAP BusinessObjects Business Intelligence 4.1 è supportata solo per documenti creati utilizzando una connettività ODBC. 71 2013-07-02 Riferimento per i driver di accesso ai dati Quando in Web Intelligence Rich Client un utente del report aggiorna un documento basato su una connettività BusinessObjects OpenConnectivity in modalità 3-tier e creato utilizzando la versione XI 3.x, viene generata la seguente eccezione: Database error: (CS) "Specified network layer is invalid : BO OC". (IES 10901) (WIS 10901) Dal momento che la connettività JDBC in modalità 3-tier non è supportata nelle versioni XI 3.x, BusinessObjects OpenConnectivity non viene riconosciuto come livello di rete quando l'utente tenta di aggiornare un documento nella versione 4.1. 6.2.1 Funzionalità di CSV OpenDriver Poiché i file di testo non forniscono alcuna operazione di database, il driver di accesso ai dati implementa le seguenti funzionalità di query: • • • • • Operazioni di base per le istruzioni SELECT (WHERE, ORDER BY, GROUP BY e AS) Operatori di base all'interno della clausola WHERE (=, <>, <, <=, >, >=, BETWEEN, NOT BETWEEN, LIKE, NOT LIKE, IS NULL, IS NOT NULL, AND, OR) Utilizzo di caratteri jolly ("?") all'interno della clausola WHERE Clausola DISTINCT all'interno dell'istruzione SELECT UNION e UNION ALL Il driver di accesso ai dati supporta anche le funzioni di raggruppamento MIN, MAX, AVG, SUM e COUNT nelle istruzioni SELECT. Restrizioni per i driver CSV OpenDriver non implementa alcuna funzionalità per la modifica dello stato del file CSV quali INSERT, UPDATE e ALTER. Il driver di accesso ai dati, inoltre, non supporta gli indici o le operazioni JOIN sui file CSV. Argomenti correlati • Disco locale utilizzato come cache per le operazioni di ordinamento Il CSV OpenDriver e i driver OData, SAP ERP, XML e di servizio Web possono utilizzare il disco locale come cache per le righe ordinate. 6.2.2 CSV OpenDriver - Mappatura di tabelle Il driver di accesso ai dati presenta i file CSV come tabelle a Information Design Tool. 72 2013-07-02 Riferimento per i driver di accesso ai dati È possibile connettersi a più file se il parametro Percorso file o motivo della procedura guidata di connessione è impostato su un motivo, ad esempio report_*.csv, che corrisponde a file quali re port_2010-09-22.csv e report_2010-09-21.csv. Promemoria: Non è possibile connettersi a più file presenti su un server HTTP. Il protocollo HTTP non supporta l'uso di caratteri jolly nei modelli. Il driver applica uno dei seguenti processi: • • Se il parametro Unisci file in uno è selezionato nella procedura guidata di connessione, tutti i file CSV vengono mappati a una sola tabella. Si presuppone che abbiano tutti il medesimo schema. Questo è il comportamento predefinito del driver di accesso ai dati. Se il parametro non è selezionato, ogni file CSV viene mappato a una tabella diversa. Mappatura di tutti i file a una tabella Il nome della tabella è il nome del criterio, ad esempio report_*.csv. La tabella possiede una colonna aggiuntiva denominata file di origine, contenente il nome del file di origine per ogni riga di tabella. Se si utilizza un file SQLDDL per fornire lo schema, il nome della tabella deve essere anche il motivo. Se i file contengono diversi nomi di colonna, i nomi delle colonne della tabella risultante sono quelli del primo file analizzato dal driver, secondo un ordine alfabetico. Mappatura di un file a una tabella Il nome di ogni tabella corrisponde al nome file dell'origine dati corrispondente. Se si utilizza un file SQLDDL per fornire lo schema, il nome della tabella nell'istruzione CREATE deve essere il nome del file. indipendentemente dal valore del parametro, il percorso del file viene mappato al qualificatore della tabella. Esempio: Nomi di colonna Se il file report_1.csv contiene le colonne col1, ... e col10, mentre il file report_2.csv contiene le colonne column1, ... e column10, le colonne della tabella risultante saranno col1, ... e col10. Esempio: Qualifier Se l'origine dati è C:\reports\report_1.csv, il qualificatore sarà C:\reports\ e il nome della tabella sarà report_1.csv. Argomenti correlati • Percorso del file CSV • Rilevamento dello schema CSV 73 2013-07-02 Riferimento per i driver di accesso ai dati 6.2.3 Percorso del file CSV CSV i file utilizzati come origini dati possono essere locali o remoti. Per i file su sistemi remoti, sono supportati i protocolli HTTP, FTP e SMB (anche noti come CIFS). La presente versione supporta anche i protocolli crittografati HTTPS e FTPS basati su un certificato. CSV i file sono disponibili nel Central Management Server (CMS) della piattaforma BI. Nota: SMB è il protocollo standard di condivisione dei file su MS Windows. Poiché la libreria jCIFS consente l'accesso al protocollo, è necessario installare il file JAR jCIFS nella directory di Connection Server, ovvero dir-installazione-connectionserver\connectionServer\sharedLibra ries\jcifs. La versione da installare è la 1.3.15, disponibile all'indirizzo http://jcifs.samba.org/. È possibile definire se l'origine dati sia locale o remota tramite il parametro Tipo di percorso della procedura guidata di connessione. Se l'origine dati è remota, è necessario impostare il protocollo utilizzato tramite il parametro Protocollo della procedura guidata. Il valore Protocollo deve corrispondere al protocollo specificato nei valori dei parametri Percorso o file motivo e File schema. Esempio: Percorsi dei file CSV • • • • C:\csv\report.csv o file:///C:/csv/report.csv per un file locale http://server:8080/path/report.csv per un file accessibile tramite HTTP ftp://server/percorso/ per i file accessibili mediante FTP smb://server:porta/condivisione/directory per i file accessibili mediante SMB 6.2.4 Rilevamento dello schema CSV Il livello di accesso ai dati offre i metodi seguenti per il rilevamento dello schema di un file CSV : • • • • Nessuna definizione Definizione automatica Utilizzo di un file DDL (Data Definition Language) Utilizzo di un file SQLDDL L'utente sceglie il metodo da applicare ai file mediante il parametro Definizione schema della procedura guidata di connessione. È possibile fornire lo schema utilizzando i file di schema (DDL o SQLDDL). Ciò si rivela utile per file di grandi dimensioni o complessi. I file vengono analizzati in ordine alfabetico. Nota: Le prime righe di un file CSV possono contenere commenti e possono essere ignorate utilizzando il parametro Numero di righe di commento all'inizio nella procedura guidata. 74 2013-07-02 Riferimento per i driver di accesso ai dati Nessun rilevamento Il driver di accesso ai dati salta le righe di commento, analizza la prima riga e determina il numero di colonne, ma non i tipi di colonna. Tutti i valori vengono considerati stringhe e la lunghezza della colonna è impostata a 255 caratteri, che corrisponde alla lunghezza standard del tipo di dati VARCHAR. Un valore eccedente 255 caratteri viene troncato. Le colonne possono contenere valori nulli. Rilevamento automatico Promemoria: Non è possibile applicare questo metodo ai file contenenti colonne a larghezza fissa. Il driver di accesso ai dati analizza i file con formato corretto e ottiene le informazioni seguenti: • nomi delle colonne Nella maggior parte dei casi, la prima riga contiene i nomi delle colonne. Altrimenti, il CSV OpenDriver genera nomi di colonna nel formato colonna_0, colonna_1, …, colonna_n. • Tipi di colonna Il driver trova i tipi di colonna utilizzando criteri predefiniti e impostazioni utente per i tipi di dati numerico, data e ora. Se una colonna contiene valori di tipo diverso, il driver considera i valori della colonna come stringhe. • Dimensioni delle colonne La dimensione di una colonna dipende dal tipo di colonna. Per i valori numerici, la dimensione della colonna è la lunghezza del valore maggiore nell'intervallo di quel tipo. Per gli altri valori, tale dimensione è la lunghezza del valore di stringa più lungo trovato durante la definizione. Avvertenza: solo quando Righe probe è impostato su tutti, il driver può trovare la stringa più lunga. • Supporto di valori nulli nella colonna Il supporto di valori nulli è "true" se è presente un valore nullo nella colonna, "false" se sono inseriti tutti i valori. A meno che non si selezionino tutte le righe, è possibile scegliere il numero di righe che il driver deve analizzare impostando il parametro Numero di righe probe nella procedura guidata di connessione. per consigli utili, consultare il Manuale dell'utente di Information Design Tool. Uso dei file DDL Il driver di accesso ai dati analizza per primo il file DDL per convertire i tipi di dati SQL in tipi di dati del driver. Il file DDL assume il formato seguente: ColumnName[:ColumnType[(Length)]]; Ad esempio: col1:VARCHAR(20); col2:DATE; col3:INTEGER; col4:INTEGER; 75 2013-07-02 Riferimento per i driver di accesso ai dati Il file DDL può definire un solo schema di tabella. Il driver assegna lo stesso schema a tutti i file CSV utilizzati come origini dati. Uso dei file SQLDDL Il driver di accesso ai dati analizza per primo il file SQLDDL per convertire i tipi di dati SQL in tipi di dati del driver. Il file SQLDDL assume il formato seguente: CREATE TABLE <Filename> ( (<ColumnName> <ColumnType> [NOT] NULL,)* (<ColumnName> <ColumnType> [NOT] NULL) ); Ad esempio: CREATE TABLE Clients ( id INTEGER NOT NULL, name CHAR(20) NULL, date DATE NULL, PRIMARY KEY (id) ) Il file SQLDDL può definire più schemi di tabella. Il driver può assegnare uno schema a più tabelle. Il driver di accesso ai dati analizza le istruzioni CREATE e ignora le altre, se presenti. Se il file DDL o SQLDDL non definisce un tipo di colonna, il driver considera i valori di colonna come stringhe di 255 caratteri. Un valore eccedente 255 caratteri viene troncato. Se il file DDL o SQLDDL specifica un tipo ma non la lunghezza, il driver utilizza le lunghezze standard, come ad esempio 10 per i numeri interi. Per il tipo di dati DECIMAL è obbligatorio definire la precisione e la scala. 6.3 Driver OData Il livello di accesso ai dati consente alla piattaforma BI di connettersi a origini dati che utilizzano il protocollo Open Data (OData). Esso fornisce un driver di accesso ai dati denominato driver OData per accedere ad origini dati online in Internet o in Intranet. Il driver OData supporta il protocollo OData 2.0, il cui schema è descritto con CSDL (Conceptual Schema Definition Language) 2.0. Il driver OData consente alla piattaforma BI di connettersi ai servizi OData esposti da SAP NetWeaver Gateway 2.0. SAP NetWeaver Gateway 2.0 consente agli utenti dell'applicazione di accedere a dati da sistemi SAP Business Suite come quelli ERP e CRM tramite HTTP. La procedura guidata di connessione offre un workflow per l'inserimento delle informazioni necessarie per connettersi alle origini dati OData. Le origini dati OData vengono visualizzate nel DBMS Generic OData 2.0 e nel livello di rete OData Connector. È possibile reperire i file di configurazione del driver nella directory dir-installazione-connec tionserver\connectionServer\odata. Il file odata.prm elenca le funzionalità del driver di accesso ai dati in termini di operazioni e funzioni di database. 76 2013-07-02 Riferimento per i driver di accesso ai dati 6.3.1 Funzionalità del driver OData Il driver di accesso ai dati supporta le seguenti funzionalità di query: • • • Operazioni di database di base (SELECT, WHERE, ORDER BY, join strutturati) Operatori di filtro di base nella clausola WHERE (=, !=, <, <=, >, >=, AND, OR, LIKE, NOT LIKE, BETWEEN, NOT BETWEEN, IS NULL, IS NOT NULL) Query nidificate nella clausola FROM Il driver di accesso ai dati supporta le operazioni AS, DISTINCT e GROUP BY, sebbene non possano essere espresse nel protocollo OData 2.0. Il driver esegue queste operazioni internamente. Limitazione: La presente versione del driver OData non supporta le seguenti funzionalità: • Operazioni UNION e UNION ALL • Clausola HAVING • DISTINCT nelle funzioni di aggregazione • Sottoquery nella clausola WHERE Funzioni di database Il driver di accesso ai dati supporta le funzioni di database AVG, MIN, MAX, e SUM, sebbene non possano essere espresse nel protocollo OData 2.0. Il driver esegue queste operazioni internamente. Il protocollo OData 2.0 supporta solo la funzione COUNT, che corrisponde all'operatore $count. Argomenti correlati • Driver OData - Mappatura di chiavi • Driver OData - Comportamenti non semplici e restrizioni • Disco locale utilizzato come cache per le operazioni di ordinamento Il CSV OpenDriver e i driver OData, SAP ERP, XML e di servizio Web possono utilizzare il disco locale come cache per le righe ordinate. 6.3.2 Posizione del servizio OData È possibile connettere servizi OData tramite HTTP. La presente versione supporta anche i protocolli crittografati HTTPS basati su un certificato. 77 2013-07-02 Riferimento per i driver di accesso ai dati Esempio: I seguenti collegamenti fanno riferimento ad esempi di servizi OData tramite HTTP e HTTPS e a un esempio di servizio SAP NetWeaver Gateway. Argomenti correlati • http://services.odata.org/Northwind/Northwind.svc/ • https://api.datamarket.azure.com/Data.ashx/data.gov/Crimes/ • http://gw.esworkplace.sap.com/sap/opu/odata/sap/SALESORDERS/ 6.3.3 Esempio di servizio OData Un'origine dati OData espone i propri dati secondo uno schema basato sull'Entity Data Model (EDM). Lo schema viene descritto con l'ausilio di CSDL. CSDL è un formato XML che descrive la struttura e la semantica degli schemi Entity Data Model. I seguenti esempi illustrano la struttura di uno schema basato su CSDL. Questo schema definisce i metadati di un'origine dati OData che fornisce il servizio Northwind. L'URI del servizio è http://ser vices.odata.org/Northwind/Northwind.svc/. Per ulteriori informazioni sui concetti che regolano un Entity Data Model, vedere la CSDL specification. Promemoria: La presente versione del driver OData non supporta elementi FunctionImport, AnnotationElement, ReferentialConstraint e proprietà dinamiche. Esempio: Schema del servizio Northwind Lo schema è accessibile da http://services.odata.org/Northwind/Northwind.svc/$metadata. Nota: Il ComplexType fittizio CustomerClothing e l'elemento Property CustomerClothes sono stati aggiunti all'esempio a scopo di documentazione. <Schema Namespace ="NorthwindModel"> ... <EntityType Name="Customer"> <Key> <PropertyRef Name="CustomerID"/> </Key> <Property Name="CustomerID" Type="Edm.String" Nullable="false" MaxLength="5" Unicode="true" FixedLe ngth="true"/> <Property Name="CompanyName" Type="Edm.String" Nullable="false" MaxLength="40" Unicode="true" FixedLe ngth="false"/> <Property Name="ContactName" Type="Edm.String" Nullable="true" MaxLength="30" Unicode="true" FixedLe ngth="false"/> <Property Name="ContactTitle" Type="Edm.String" Nullable="true" MaxLength="30" Unicode="true" FixedLe ngth="false"/> <Property Name="CustomerClothes" Type="NorthwindModel.CustomerClothing" Nullable="false"> ... <NavigationProperty Name="Orders" Relationship="NorthwindModel.FK_Orders_Customers" FromRole="Customers" 78 2013-07-02 Riferimento per i driver di accesso ai dati ToRole="Orders"/> <NavigationProperty Name="CustomerDemographics" Relationship="NorthwindModel.CustomerCustomerDemo" From Role="Customers" ToRole="CustomerDemographics"/> </EntityType> <ComplexType Name="CustomerClothing"> <Property Name="Suit" Type="Edm.String" Nullable="false"> <Property Name="Shoes" Type="Edm.String" Nullable="true"> ... </ComplexType> <Association Name="FK_Orders_Customers"> <End Role="Customers" Type="NorthwindModel.Customer" Multiplicity="0..1"/> <End Role="Orders" Type="NorthwindModel.Order" Multiplicity="*"/> <ReferentialConstraint> ... </ReferentialConstraint> </Association> ... </Schema> <Schema Namespace="ODataWeb.Northwind.Model"> <EntityContainer Name="NorthwindEntities" p7:LazyLoadingEnabled="true" m:IsDefaultEntityContainer="true"> ... <EntitySet Name="Customers" EntityType="NorthwindModel.Customer"/> <EntitySet Name="Employees" EntityType="NorthwindModel.Employee"/> <EntitySet Name="Order_Details" EntityType="NorthwindModel.Order_Detail"/> <EntitySet Name="Orders" EntityType="NorthwindModel.Order"/> <EntitySet Name="Products" EntityType="NorthwindModel.Product"/> ... <AssociationSet Name="FK_Orders_Customers" Association="NorthwindModel.FK_Orders_Customers"> <End Role="Customers" EntitySet="Customers"/> <End Role="Orders" EntitySet="Orders"/> </AssociationSet> <AssociationSet Name="FK_Employees_Employees" Association="NorthwindModel.FK_Employees_Employees"> <End Role="Employees" EntitySet="Employees"/> <End Role="Employees1" EntitySet="Employees"/> </AssociationSet> ... </EntityContainer> </Schema> 6.3.4 Driver OData - Mappatura di spazio dei nomi, proprietario e qualificatore L'attributo Namespace dello schema viene mappato allo spazio dei nomi del modello. L'EntityContainer viene mappato al qualificatore di database. Il qualificatore predefinito è l'EntityContainer con l'attributo m:IsDefaultEntityContainer impostato su true. Gli EntityContainer sono elementi secondari degli elementi Schema. Poiché elementi Schema differenti possono contenere lo stesso EntityContainer, il valore del qualificatore di database è <Spazio dei nomi_schema>.<Nome_EntityContainer>. La presente versione del driver espone un solo proprietario, che viene definito entities. Esempio: Lo spazio dei nomi del servizio Northwind è ODataWeb.Northwind.Model. 79 2013-07-02 Riferimento per i driver di accesso ai dati Il qualificatore di database del servizio Northwind è ODataWeb.Northwind.Model.NorthwindEn tities. Il proprietario di database del servizio Northwind è entities. 6.3.5 Driver OData - Mappatura di tabelle Il driver di accesso ai dati espone feed OData come tabelle a Information Design Tool. Un EntitySet viene mappato a una tabella. L'attributo Name dell'EntitySet viene mappato al nome della tabella. Nello schema OData, un AssociationSet collega due EntitySet. Un AssociationSet viene mappato a una tabella, se la molteplicità di entrambi gli EntitySet è *. L'attributo Name dell'AssociationSet viene mappato al nome di tabella. Se almeno una delle molteplicità degli EntityType è 1 o 0..1, l'AssociationSet viene mappato a una chiave esterna. Esempio: Mappatura di EntitySet I seguenti EntitySet del servizio Northwind vengono mappati a tabelle: • • • Customers Orders Products Esempio: Mappatura di AssociationSet Anche i seguenti AssociationSet del servizio Northwind vengono mappati a tabelle: • • CustomerCustomerDemo EmployeeTerritories L'AssociationSet CustomerCustomerDemo viene mappato alla tabella CustomerCustomerDemo, poiché l'Association CustomerCustomerDemo collega entrambi gli EntityType CustomerDemogra phic e Customer a molteplicità *. <Association Name="CustomerCustomerDemo"> <End Role="CustomerDemographics" Type="NorthwindModel.CustomerDemographic" Multiplicity="*"/> <End Role="Customers" Type="NorthwindModel.Customer" Multiplicity="*"/> </Association> Argomenti correlati • Driver OData - Mappatura di chiavi 80 2013-07-02 Riferimento per i driver di accesso ai dati 6.3.6 Driver OData - Mappatura di colonne Un EntitySet viene definito da un EntityType. Un EntityType è costituito da una serie di proprietà. Una proprietà di tipo primitivo viene mappata a una colonna della tabella che rappresenta un EntitySet. L'attributo Name della proprietà viene mappato al nome di colonna. Una proprietà di tipo complesso viene mappata a un set di colonne di tabella. Una colonna corrisponde a una sottoproprietà. Il nome di colonna è la concatenazione dei nomi delle proprietà di tipo complesso e di tipo primitivo, separati da una barra (/). Questa mappatura si applica anche a proprietà nidificate di tipo complesso. Esempio: La tabella Orders include la colonna OrderID, poiché l'EntityType Order include la proprietà Orde rID. La tabella Customers include le colonne Address, CustomerClothes/Suit e Customer Clothes/Shoes, poiché: • • La proprietà Address dell'EntityType Customer ha un tipo primitivo. La proprietà CustomerClothes dell'EntityType Customer ha un tipo complesso, che è costituito dalle proprietà Suit e Shoes di tipo primitivo. 6.3.7 Driver OData - Mappatura di chiavi Mappatura di chiavi primarie La chiave di un EntityType viene mappata alla chiave primaria della tabella che mappa l'EntitySet corrispondente. Questa operazione può essere eseguita su una o più colonne. Esempio: La tabella Customers ha una chiave primaria sulla colonna CustomerID, poiché l'EntityType Cus tomer ha una chiave che fa riferimento alla proprietà CustomerID. Mappatura di chiavi esterne Il protocollo OData utilizza NavigationProperty per esporre i percorsi di join di un modello relazionale. Le NavigationProperty utilizzano ruoli definiti in AssociationSet per collegare EntitySet in base alla loro molteplicità. Il driver OData rappresenta join bidirezionali come chiavi esterne. È possibile creare un join bidirezionale tra tabelle se gli EntityType degli EntitySet che rappresentano queste tabelle contengono 81 2013-07-02 Riferimento per i driver di accesso ai dati NavigationProperty che utilizzano lo stesso AssociationSet per collegare EntitySet. Questo significa che entrambe le estremità di un AssociationSet devono avere NavigationProperty in entrambi gli EntityType. Le associazioni che non soddisfano questa condizione non vengono esposte come chiavi primarie. Se la molteplicità di entrambi gli EntitySet è *, l'AssociationSet viene mappato a una tabella. Se almeno una delle molteplicità degli EntityType è 1 o 0..1, l'AssociationSet viene mappato a una chiave esterna nella tabella che rappresenta l'EntitySet della molteplicità *. Lo schema del nome di una chiave esterna è -idref-<NavigationProperty>-<chiave primaria>. Promemoria: Le chiavi esterne sono colonne delle tabelle della base dati nascoste per impostazione predefinita, poiché non contengono dati aziendali. Tuttavia è possibile visualizzarle modificando le proprietà di tabelle e colonne. Consultare il Manuale dell'utente di Information Design Tool. Avvertenza: SAP consiglia agli utenti dell'applicazione di non eseguire query sulle colonne -idref, poiché tale operazione può compromettere le prestazioni del driver. Esempio: Chiavi esterne di un EntitySet La tabella Orders ha chiavi esterne -idref-Customer-CustomerID, -idref-Employee-Em ployeeID e -idref-Shipper-ShipperID, poiché: • L'EntityType Order ha le seguenti NavigationProperty. <EntityType Name="Order"> ... <NavigationProperty Name="Customer" Relationship="NorthwindModel.FK_Orders_Customers" FromRole="Orders" ToRole="Customers"/> <NavigationProperty Name="Employee" Relationship="NorthwindModel.FK_Orders_Employees" FromRole="Orders" ToRole="Employees"/> <NavigationProperty Name="Shipper" Relationship="NorthwindModel.FK_Orders_Shippers" FromRole="Orders" ToRole="Shippers"/> </EntityType> • Queste NavigationProperty fanno riferimento a FK_Orders_ Association, che collegano l'EntityType Order agli EntityType Customer, Employee e Shipper. C'è una sola molteplicità 0..1 in ogni associazione. Questo genera tre chiavi esterne nella tabella che rappresenta l'EntitySet Orders. <Association Name="FK_Orders_Employees"> <End Role="Employees" Type="NorthwindModel.Employee" Multiplicity="0..1"/> <End Role="Orders" Type="NorthwindModel.Order" Multiplicity="*"/> </Association> • • • Il CustomerID in -idref-Customer-CustomerID deriva dalla chiave primaria della tabella Customers. L'EmployeeID in -idref-Employee-EmployeeID deriva dalla chiave primaria della tabella Employees. Lo ShipperID in -idref-Shipper-ShipperID deriva dalla chiave primaria della tabella Shippers. Esempio: Chiavi esterne di un AssociationSet La tabella CustomerCustomerDemo ha le chiavi esterne -idref-CustomerDemographics-Cus tomerTypeID e -idref-Customers-CustomerID poiché: 82 2013-07-02 Riferimento per i driver di accesso ai dati • L'EntityType Customer ha una NavigationProperty CustomerDemographics. <EntityType Name="Customer"> ... <NavigationProperty Name="CustomerDemographics" Relationship="NorthwindModel.CustomerCustomerDemo" FromRole="Customers" ToRole="CustomerDemographics"/> </EntityType> • L'EntityType CustomerDemographic ha una NavigationProperty Customers. <EntityType Name="CustomerDemographic"> ... <NavigationProperty Name="Customers" Relationship="NorthwindModel.CustomerCustomerDemo" FromRole="Cus tomerDemographics" ToRole="Customers"/> </EntityType> • L'elemento NavigationProperties fa riferimento all'associazione CustomerCustomerDemo, che collega gli EntityType Customer e CustomerDemographic. Questo genera due chiavi esterne nella tabella che rappresenta l'AssociationSet CustomerCustomerDemo. <Association Name="CustomerCustomerDemo"> <End Role="CustomerDemographics" Type="NorthwindModel.CustomerDemographic" Multiplicity="*"/> <End Role="Customers" Type="NorthwindModel.Customer" Multiplicity="*"/> </Association> • • Il CustomerID in -idref-Customers-CustomerID deriva dalla chiave primaria della tabella Customers. Il CustomerTypeID in -idref-CustomerDemographics-CustomerTypeID deriva dalla chiave primaria della tabella CustomerDemographics. 6.3.8 Driver OData - Mappatura degli elementi Documentation A seconda della disponibilità, i sottoelementi Summary o LongDescription di Documentation vengono mappati a descrizioni delle entità del modello relazionale. Un sottoelemento Documentation di EntitySet e AssociationSet viene visualizzato come descrizione di tabella in Information Design Tool. Un sottoelemento Documentation di Property o NavigationProperty viene visualizzato come descrizione di colonna. Se non è disponibile alcun elemento Summary o LongDescription, il campo Description resta vuoto. Le descrizioni non vengono localizzate. 6.3.9 Driver OData - Mappatura di entità di tipi derivati Il seguente esempio illustra un EntitySet di tipo Employee. <EntitySet Name="Employees" EntityType="Employee" /> 83 2013-07-02 Riferimento per i driver di accesso ai dati Il seguente diagramma mostra il concetto di eredità tra un tipo di base Dipendente e due tipi derivati, Dipendente esterno e Dipendente interno. I tipi derivati ereditano da tutte le proprietà del tipo di base. Definiscono inoltre ulteriori proprietà, che vengono definite proprietà dirette. Per un EntitySet specifico, lo schema prodotto il risultato di un'unione con un tipo generale. Il seguente diagramma mostra la tabella Employee come rappresentata nel modello relazionale. La tabella Employee del modello relazionale conterrà informazioni di entrambe le entità, ovvero colonne del tipo principale e dei tipi derivati. Per evitare conflitti di denominazione, alle colonne dichiarate nei tipi derivati viene aggiunto un prefisso con il nome dell'EntityType. Tali colonne possono inoltre contenere il valore null. 6.3.10 Monitoraggio delle prestazioni del driver OData Per migliorare le prestazioni della connessione in fase di esecuzione della query, è possibile considerare i seguenti comportamenti del driver OData. Esecuzione di operazioni sul lato client o provider Quando si crea una connessione, è possibile scegliere di eseguire alcune operazioni della query SQL a livello di driver o provider. Nella seguente tabella sono riportati i parametri della procedura guidata di connessione che controllano questo comportamento. 84 2013-07-02 Riferimento per i driver di accesso ai dati Se viene selezionato un parametro, il provider di servizi OData gestisce l'operazione corrispondente, se può supportarla. Si tratta del comportamento predefinito. Se non viene selezionato, il driver OData gestisce l'operazione. Avvertenza: SAP consiglia di non utilizzare il driver di accesso ai dati per eseguire queste operazioni, poiché può compromettere le prestazioni della connessione. Poiché l'intero set di dati deve essere trasferito al client, i tempi di risposta aumentano. Utilizzarlo solo se il provider di servizi OData non supporta, o supporta solo parzialmente, l'operazione. Parametro Opera zione Impatto sulle prestazioni Selezione colonna SELECT Se il parametro non è selezionato, il driver OData gestisce la proiezione SQL, aumentando notevolmente il traffico dati. Alcune operazioni di filtro possono essere eseguite a livello del driver, se gli standard OData non le supportano. Tuttavia, i filtri sul provider riducono di norma i tempi di esecuzione delle query. Condizioni filtro supportate Ordinamento WHERE ORDER BY Il livello di accesso ai dati applica la seguente logica per migliorare le prestazioni: tutte le condizioni di filtro compatibili con gli standard OData vengono inviate al provider OData. Il driver OData esegue tutti gli altri filtri incompatibili eventualmente contenuti nella clausola WHERE. Vedere l'esempio seguente. Il provider OData esegue l'operazione ORDER BY, se nella query non viene utilizzata alcuna espressione DISTINCT o GROUP BY. Se una query contiene un'espressione DISTINCT o GROUP BY, il driver deve eseguire l'operazione di ordinamento, che allunga i tempi di esecuzione. Nota: • • • Quando viene eseguita dal driver, l'operazione ORDER BY dipende dal parametro SBO Bucket Split Size. L'operatore BETWEEN viene mappato a funzioni di confronto OData e quindi eseguito dal provider OData. Gli operatori LIKE e NOT LIKE vengono di norma eseguiti sul client. Vengono però convertiti nelle funzioni OData startsWith e endsWith, se viene posizionato un solo criterio % rispettivamente alla fine o all'inizio del valore di filtro. Esempio: Supporto di espressioni di filtro La seguente query contiene due condizioni di filtro nella clausola WHERE: SELECT * FROM T1 WHERE col1='San Francisco' AND col2 LIKE 'S%n' 85 2013-07-02 Riferimento per i driver di accesso ai dati Il provider OData può gestire la prima parte della clausola, ma non la seconda. Il driver OData esegue quindi col2 LIKE 'S%n', mentre il provider esegue col1='San Francisco'. Esempio: Mappatura delle funzioni startsWith ed endsWith La seguente query SQL restituisce i dipendenti della divisione Sales che vivono su boulevard. SELECT * FROM EMPLOYEES WHERE EMPLOYEES."Title" LIKE 'Sales %' AND EMPLOYEES."Address" LIKE '% Blvd.' Corrisponde all'URI seguente: http://services.odata.org/Northwind/Northwind.svc/Employees?$filter=startswith(Title,'Sales')&endswith(Ad dress,'Blvd.') Esecuzione di funzioni di aggregazione La funzione di database COUNT è la sola funzione di aggregazione supportata dal protocollo OData 2.0. Altre funzioni di aggregazione e raggruppamenti attivati dalla clausola GROUP BY vengono eseguiti sul client. Se però il driver esegue calcoli che modificano il risultato prima che venga eseguito il conteggio, anche la funzione COUNT deve essere eseguita sul client. Ciò può compromettere le prestazioni della connessione. Utilizzo del metamodello cache Il parametro Metamodello cache viene selezionato per impostazione predefinita nella procedura guidata di connessione. Consente di recuperare il modello di metadati una sola volta per tutta la durata della connessione nel pool di connessioni, invece di recuperarlo ogni volta che viene eseguita una query. Ciò migliora le prestazioni della connessione. Nota: Se il modello di metadati è memorizzato nella cache, è necessario abilitare il pool delle connessioni. Argomenti correlati • Funzionalità del driver OData 6.3.11 Driver OData - Comportamenti non semplici e restrizioni Algoritmi di ordinamento Gli algoritmi di ordinamento possono variare da un provider di servizi all'altro. Ciò può produrre risultati diversi quando nella query viene utilizzato ORDER BY. Poiché il driver OData può eseguire operazioni di ordinamento utilizzando un proprio algoritmo, anche l'uso di operazioni combinate come ORDER BY, GROUP BY e DISTINCT può produrre ordinamenti diversi. 86 2013-07-02 Riferimento per i driver di accesso ai dati Mappatura del parametro N. max di righe La funzione OData $top viene mappata al parametro N. max di righe del pannello delle query, solo se le operazioni di query non modificano il numero di righe. I risultati della query possono essere errati se viene applicato un filtro, che rimuove alcune righe dal risultato $top previsto. Esempio: La seguente query OData restituisce le prime 15 righe dalla tabella Orders: http://services.odata.org/Northwind/Northwind.svc/Orders?$top=15 La seguente query restituisce le prime 15 righe in cui la città di spedizione è "Reims". Questa restituisce solo 5 righe: http://services.odata.org/Northwind/Northwind.svc/Orders?$top=15&$filter=ShipCity eq 'Reims' Restrizioni della funzione COUNT Il conteggio righe di una tabella in Information Design Tool equivale al conteggio semantico delle righe che contengono valori non null per le colonne definite. Alcuni servizi Azure restituiscono solo il numero totale di righe di una tabella. Ciò può causare una discrepanza tra i risultati previsti e quelli effettivi della query. Restrizioni dei servizi SAP NetWeaver Gateway Se il provider di servizi NetWeaver Gateway non supporta filtri su tutte le colonne, non si deve selezionare Condizioni filtro supportate quando si crea la connessione. Se non supporta l'ordinamento su tutte le colonne, non si deve selezionare Ordinamento quando si crea la connessione. Lo schema può indicare queste restrizioni di filtro e ordinamento con l'ausilio dei metadati sap:filte rable e sap:sortable. Nella presente versione, il driver OData non mappa questi attributi. Alcuni provider potrebbero non offrire la funzionalità di analisi di un'intera tabella per tutte le tabelle. Ciò può provocare errori di runtime, se, ad esempio, una delle tabelle coinvolte in un JOIN non può essere analizzata. SAP consiglia di creare connessioni dirette al sistema SAP ERP, per evitare problemi con le query ad hoc. 6.3.12 Driver OData - Configurazione della dimensione massima delle colonne Per alcune proprietà, il parametro MaxLength potrebbe avere il valore Max. Ad esempio: <Property Name="Synopsis" Type="Edm.String" Nullable="true" MaxLength="Max" Unicode="true" FixedLe ngth="false"/> Poiché il driver OData non può riconoscere questo valore non numerico, è necessario procedere alla configurazione. Il file di configurazione cs.cfg fornisce i seguenti parametri: • 87 Binary Max Length, per impostare la dimensione massima delle colonne di tabella di tipo binario 2013-07-02 Riferimento per i driver di accesso ai dati • String Max Length, per impostare la dimensione massima delle colonne di tabella di tipo stringa Argomenti correlati • Binary Max Length • Lunghezza massima 6.3.13 Autenticazione di origini OData L'accesso ad alcune origini dati OData richiede l'autenticazione. Un'applicazione può autenticarsi per un'origine dati OData con i seguenti metodi: • • Autenticazione di base HTTP, che utilizza nome utente e password. Le credenziali non vengono crittografate. Un token di accesso GET, ovvero una coppia {chiave, valore} aggiunta all'URI del servizio. La chiave e il valore del token possono variare in base al servizio. Impostare il token con parametri personalizzati, utilizzando Parametri personalizzati di autenticazione nella procedura guidata di connessione. Utilizzare lo schema seguente: <chiave>=<valore>. Nota: Il livello di accesso ai dati non fornisce analisi per i parametri di autenticazione personalizzati, poiché questi contengono informazioni di sicurezza. Tali parametri vengono sostituiti da <CUSTOM_AUTH_PA RAMS> nelle analisi dei driver OData. Prendere però in considerazione l'utilizzo di altri livelli di analisi, come l'opzione Abilita analisi processo della CMC, per visualizzare i parametri. Esempio: Token di accesso http://wine.cloudapp.net/Regions?apikey=<valore chiave api>. Autenticazione di origini dati Microsoft Azure Per connettersi a un insieme di dati Microsoft Azure si utilizza l'autenticazione di base HTTP. Nella procedura guidata di connessione immettere la chiave account come password. È possibile lasciare vuoto il campo del nome utente. 6.3.14 Analisi dell'attività del driver OData Il livello di accesso ai dati analizza il driver OData con i livelli di gravità PATH e DEBUG. Le analisi PATH contengono le voci e le uscite di ogni metodo utilizzato nella pianificazione e nell'esecuzione di query. Consente di capire se il driver o il provider OData ha eseguito un'operazione di interrogazione e dove può essere la causa del problema. 88 2013-07-02 Riferimento per i driver di accesso ai dati Le informazioni contenute nell'URI (credenziali dell'origine dati, credenziali del server proxy e parametri di autenticazione personalizzati) vengono cancellate nelle analisi del driver. 6.4 Driver SAP ERP Il livello di accesso ai dati consente alla piattaforma BI di connettersi ai sistemi SAP ERP tramite il livello di rete Java Connector (JCo) 3.x. Fornisce un driver di accesso ai dati che consente di accedere ai seguenti oggetti ERP: • • • InfoSet Query SAP Funzioni ABAP Per maggiori informazioni sui sistemi SAP ERP supportati, consultare Product Availability Matrix La connettività SAP ERP supporta Single Sign-On (SSO) su tutte le piattaforme. Per maggiori informazioni sull'autenticazione, vedere il Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence La connettività SAP ERP supporta anche le impostazioni internazionali di visualizzazione preferite per tutte le modalità di autenticazione. Quando si crea la connessione, l'utilizzo di tali impostazioni viene disattivato selezionando Salva lingua. È possibile reperire i file di configurazione del driver nella directory dir-installazione-connec tionserver\connectionServer\jco. Il file jco.prm elenca le funzionalità del driver di accesso ai dati in termini di operazioni del database. La procedura guidata di connessione offre un workflow per l'inserimento delle informazioni necessarie per connettersi ai sistemi SAP ERP. Argomenti correlati • Supporto Single Sign On 6.4.1 Funzionalità dei driver SAP ERP Il driver di accesso ai dati supporta le seguenti funzionalità di query: • • • • 89 Operazioni di base (SELECT, WHERE, ORDER BY, GROUP BY e AS) Operatori di base (=, !=, <, <=, >, >=, BETWEEN, NOT BETWEEN, IN, NOT IN, AND, OR) i cui operandi possono essere nomi di colonne o valori costanti Clausola DISTINCT all'interno dell'istruzione SELECT Valori costanti nell'istruzione SELECT 2013-07-02 Riferimento per i driver di accesso ai dati • • LIKE e NOT LIKE accettano caratteri di Escape Query nidificate nella clausola FROM Il livello di accesso ai dati esegue le operazioni di ordinamento internamente. Nota: Il driver di accesso ai dati non consente di ordinare le colonne per indice nelle istruzioni SQL. Solo la clausola ORDER BY con i nomi della colonna è valida. Il parametro ORDER_BY_SUPPORTS_COLUMN_IN DEX è impostato su NO nel file jco.prm. Argomenti correlati • Disco locale utilizzato come cache per le operazioni di ordinamento Il CSV OpenDriver e i driver OData, SAP ERP, XML e di servizio Web possono utilizzare il disco locale come cache per le righe ordinate. • ORDER_BY_SUPPORTS_COLUMN_INDEX 6.4.2 Driver SAP ERP - Accesso a InfoSet e query SAP Informazioni su InfoSet e query SAP Nel sistema SAP ERP, gli InfoSet e le query SAP sono organizzati in un'area di lavoro locale o globale. Gli oggetti dell'area di lavoro locale risultano accessibili solo al client SAP ERP utilizzato, mentre quelli dell'area di lavoro globale sono accessibili a tutti i client. Una query SAP viene creata in un gruppo di utenti e appartiene ad esso. Per maggiori informazioni sulle aree di lavoro e i gruppi di utenti, consultare la documentazione relativa a SAP ERP. Mappatura di oggetti Il driver di accesso ai dati presenta InfoSet e le query SAP come tabelle a Information Design Tool. InfoSet e le query SAP sono costituite da una serie di campi mappati alle colonne della tabella. Campi utilizzati nelle istruzioni SELECT. A livello driver, le aree di lavoro vengono mappate a qualificatori. Il qualificatore predefinito corrisponde all'area di lavoro locale. I gruppi di utenti vengono mappati a proprietari. I gruppi di utenti di un'area di lavoro vengono quindi collocati al di sotto di un qualificatore che rappresenta tale area. Gli InfoSet di un'area di lavoro vengono collocati al di sotto di un qualificatore che rappresenta quest'area di lavoro e di un proprietario fittizio denominato INFOSET. Le query SAP di un'area di lavoro sono collocate al di sotto del qualificatore che rappresenta tale area. Le query SAP di un gruppo di utenti sono collocate al di sotto del proprietario che rappresenta tale gruppo. L'organizzazione di InfoSet e query SAP in un'area di lavoro è illustrata nella figura seguente: 90 2013-07-02 Riferimento per i driver di accesso ai dati I campi sono mappati alle colonne della tabella. Un InfoSet o una query SAP contiene i campi che sono sia campi di selezione che di proiezione. Contiene inoltre i campi di selezione non utilizzati per la proiezione. Quando si crea una connessione mediante la procedura guidata di connessione, si sceglie se tali campi di selezione debbano essere rappresentati come colonne di tabella. Il parametro Map Selection Fields into Table Columns si rivela utile per questa funzionalità. Se questa opzione è selezionata, il campo viene mappato come una colonna di input facoltativa. Se non è selezionata, il campo di selezione viene ignorato e non è possibile applicare il filtro su questo campo. Nota: Non esiste una mappatura specifica per i campi di selezione obbligatori. L'utente dell'applicazione deve interrogare questi campi con filtri. Colonne di input Le colonne di input di una tabella sono colonne su cui deve essere specificata una condizione di uguaglianza (operatore =), quando l'utente dell'applicazione interroga la tabella. Sulle colonne di input sono consentite solo condizioni di uguaglianza. Le condizioni IN non sono consentite. In Information Design Tool, l'utente può visualizzare le colonne di input come obbligatorie oppure opzionali. Una colonna di input obbligatoria è una colonna per cui è necessario impostare un valore. Una colonna di input opzionale è una colonna per cui non è necessario impostare un valore. Se l'utente non imposta un valore su una colonna di input facoltativa in una query, Connection Server restituisce uno dei seguenti valori: 91 2013-07-02 Riferimento per i driver di accesso ai dati • • Nessun valore se la colonna di input facoltativo non contiene un valore predefinito Il valore predefinito se la colonna di input facoltativo contiene un valore predefinito Driver Capabilities Quando l'utente dell'applicazione interroga un InfoSet, alcune operazioni del database vengono trasferite al sistema SAP ERP (SELECT, WHERE, ordinamento solo con le colonne ORDER BY, ed AS), mentre le altre vengono gestite internamente dal driver (altri filtri con WHERE, GROUP BY, DISTINCT e ordinamento solo con le funzioni di aggregazione ORDER BY). Quando l'utente dell'applicazione interroga una query SAP, anche alcune operazioni vengono trasferite al sistema ERP; si tratta di SELECT, WHERE, ORDER BY (solo se la query SAP contiene già lo stesso ordinamento) e AS. Per maggiori informazioni sulle operazioni gestite direttamente dal sistema, consultare la documentazione del sistema SAP ERP. 6.4.3 Driver SAP ERP - Accesso alle funzioni ABAP Promemoria: il driver SAP ERP consente di creare connessioni alle funzioni ABAP rilasciate e non rilasciate. Concetti sulle funzioni ABAP Le funzioni ABAP sono costituite da una serie di parametri che possono essere parametri di input, utilizzati in chiamate di funzioni, o parametri di output, contenuti nelle risposte alla chiamata. Nella terminologia SAP, i parametri di input sono chiamati di importazione, mentre i parametri di output sono chiamati di esportazione. Alcuni parametri possono essere sia di input che di output. questi vengono definiti parametri mutevoli. Oltre ai parametri mutevoli, di importazione e di esportazione, esistono anche parametri di tabella che possono essere considerati come un tipo di parametri mutevoli. Una parametro di una funzione ABAP può includere il seguente tipo: • • • Campo di tipo ABAP primitivo Struttura, che rappresenta una sequenza di diversi campi Tabella, che può essere composta da campi, strutture o anche tabelle Mappatura di oggetti Il driver di accesso ai dati presenta le funzioni ABAP come tabelle ad Information Design Tool. A livello di driver, i gruppi di funzioni ABAP sono mappati ai proprietari e le funzioni ABAP sono mappate a un qualificatore denominato ABAPFunction. Ciò significa che ogni funzione ABAP è collocata sotto uno specifico proprietario che corrisponde a un gruppo di funzioni nel sistema SAP ERP. I parametri di importazione, mutevoli e di tabella utilizzati come input sono mappati alle colonne di input. I parametri di esportazione, mutevoli e di tabella utilizzati come output sono mappati alle tabelle. Le colonne di input possono essere obbligatorie oppure opzionali. Il livello di accesso ai dati considera questi parametri come attributi chiave primari, che non sono nullable. 92 2013-07-02 Riferimento per i driver di accesso ai dati Il driver mappa i parametri della funzione ABAP come segue: • Un parametro obbligatorio viene mappato a una colonna di input obbligatoria. L'utente deve impostare un valore per questa colonna. • Un parametro opzionale provvisto di un valore di default viene mappato a una colonna di input opzionale. L'utente non deve impostare un valore in questa colonna. Il valore restituito a Connection Server dall'origine dati in quel caso è il valore di default. • Un parametro opzionale senza un valore predefinito viene mappato anche a una colonna di input opzionale. Connection Server restituisce i seguenti valori del tipo di dati stringa in base al tipo SQL della colonna di input: Tipo SQL Valore SQL_Integer 0 SQL_Char, SQL_VarChar, SQL_Binary Stringa vuota SQL_Double, SQL_Float, SQL_Numeric 0.0 SQL_Date 00010101 SQL_Time 000000 Qualsiasi altro tipo Stringa vuota Nota: il driver aggiunge una colonna <nome colonna>-ID alla tabella, a cui la funzione ABAP è mappata e un'altra colonna <nome_colonna>-IDREF alla tabella se contiene un riferimento a un'altra tabella. Ridenominazione delle colonne I nomi delle colonne vengono rinominati a livello del driver. La seguente tabella mostra i prefissi aggiunti alle colonne. 93 2013-07-02 Riferimento per i driver di accesso ai dati Input o output Parametro Prefisso Input Importazione -IMPORT_ Input Mutevole -IMPORT_CH_ Input Tabella -IMPORT_CH_ Output Mutevole -EXPORT_CH_ Output Tabella -EXPORT_CH_ Nota: quando un parametro di tabella di output (A) è costituito da un'altra tabella (B), entrambe le tabelle vengono rinominate in -EXPORT_CH_A e -EXPORT_CH_A.B, rispettivamente. Driver Capabilities Tutte le operazioni del database (SELECT, WHERE, ORDER BY, GROUP BY, AS, ecc.) vengono gestite internamente dal driver, mentre le condizioni di uguaglianza sulle colonne di input vengono trasferite al sistema SAP ERP. Promemoria: il driver accetta solo le tabelle con una singola riga come parametri di input. Sono equivalenti alle strutture di input. • Quando si crea una connessione nella creazione guidata connessione, l'utente dell'applicazione decide se un parametro mutevole di tipo tabella o un parametro di tabella deve essere considerato come input e output. Il parametro Map Table Parameters into Input Columns è utile per questa funzionalità. Se viene selezionato, il parametro è sia di input che di output; in questo caso, può essere solo una struttura come input. In caso contrario, il parametro viene considerato solo come un parametro di output. • Il driver considera i campi di una struttura di input opzionale come colonne di input opzionali. Le colonne di input sono considerate opzionali nell'insieme; ovvero, se una colonna presenta un valore, anche le altre dovranno avere un valore. L'utente dell'applicazione deve assicurare che tutte le colonne presentino un valore. • Alcuni parametri della funzione ABAP possono contenere valori le cui dimensioni risultano uguali a zero in base a quanto indicato dal sistema SAP ERP. Il driver utilizza il parametro String Max Length del file cs.cfg per impostare una lunghezza massima di stringa per le colonne della tabella mappate a tali parametri. Argomenti correlati • Lunghezza massima 94 2013-07-02 Riferimento per i driver di accesso ai dati 6.4.4 Restrizioni dei driver SAP ERP • • Non è possibile interrogare oggetti ERP basati su programmi ABAP che implichino un'elaborazione SAPGUI, poiché non sono accessibili mediante Remote Function Call. L'API JCo non supporta l'array fetch. Ciò significa che i risultati vengono restituiti tutti insieme. Al fine di limitare il numero di righe risultanti e di evitare problemi legati all'esaurimento della memoria, l'utente dell'applicazione deve filtrare i dati in modo appropriato. Indipendentemente da tale restrizione, Connection Server continua ad applicare l'array fetch. Nota: L'utente dell'applicazione può anche impostare un valore per Max Rows nel pannello delle query. Tuttavia, il sistema SAP ERP non prende in considerazione Max Rows se l'universo definito ha più origini o se la query richiede calcoli dopo il recupero dei dati (SELECT DISTINCT, ORDER BY e GROUP BY). • Il parametro ERP Max Rows del file di configurazione jco.sbo consente all'utente dell'applicazione di interrogare senza filtro un InfoSet o una tabella query SAP contenente solo colonne di dati di tipo numerico. L'utente può anche interrogare una tabella contenente colonne di dati DATS e numerici. Questo parametro viene utilizzato anche quando Max Rows non viene trasferito al sistema SAP ERP. ERP Max Rows può essere utilizzato con universi a più origini o a una sola origine. Impostare ERP Max Rows su un valore adeguato per evitare problematiche legate all'esaurimento della memoria. Nota: Nel caso di universi a più origini, è anche possibile impostare un valore del parametro Max Rows del pannello delle query dello strumento di amministrazione di Data Federation. Consultare il Manuale dello strumento di amministrazione di Data Federation per maggiori informazioni. Argomenti correlati • Dimensioni array fetch • ERP Max Rows 6.5 Driver XML Il livello di accesso ai dati consente alla piattaforma BI di connettersi a documenti XML come origini dati. I documenti XML sono basati su schemi XML. Uno schema XML è un documento XSD che definisce i metadati di un'origine dati XML. 95 2013-07-02 Riferimento per i driver di accesso ai dati La procedura guidata di connessione offre un workflow per l'inserimento delle informazioni necessarie per connettersi alle origini dati XML. Le origini dati XML vengono visualizzate nel DBMS XML Files e nel livello di rete XML File Connector. È possibile reperire i file di configurazione del driver nella directory dir-installazione-connec tionserver\connectionServer\xml. Il file xml.prm elenca le funzionalità del driver di accesso ai dati in termini di operazioni e funzioni di database. 6.5.1 Funzionalità del driver XML I driver di accesso ai dati supportano le seguenti funzionalità di query: • • • • Operazioni database di base (SELECT, WHERE, ORDER BY, GROUP BY, DISTINCT) Alias di colonna nella clausola ORDER BY (AS) Query nidificate nella clausola FROM Operatori di filtro ( =, !=, <, <=, >, >=, AND, OR, BETWEEN, NOT BETWEEN, IN, NOT IN, LIKE, NOT LIKE, IS NULL, IS NOT NULL) Il driver di accesso ai dati non supporta operazioni JOIN. Il driver di accesso ai dati supporta le funzioni di raggruppamento MIN, MAX, AVG, SUM e COUNT nelle istruzioni SELECT. Argomenti correlati • Disco locale utilizzato come cache per le operazioni di ordinamento Il CSV OpenDriver e i driver OData, SAP ERP, XML e di servizio Web possono utilizzare il disco locale come cache per le righe ordinate. 6.5.2 Posizione dei file XML I documenti XML utilizzati come origini dati possono essere locali o remoti. Per i file su sistemi remoti sono supportati i protocolli HTTP, FTP e SMB. La presente versione supporta anche i protocolli crittografati HTTPS e FTPS basati su un certificato. Nota: SMB è il protocollo standard di condivisione dei file su MS Windows. Poiché la libreria jCIFS consente l'accesso al protocollo, è necessario installare il file JAR jCIFS nella directory di Connection Server, ovvero dir-installazione-connectionserver\connectionServer\sharedLibra ries\jcifs. La versione da installare è la 1.3.15, disponibile all'indirizzo http://jcifs.samba.org/. È possibile definire se l'origine dati sia locale o remota tramite il parametro Tipo di percorso della procedura guidata di connessione. Se l'origine dati è remota, è possibile impostare il protocollo utilizzato 96 2013-07-02 Riferimento per i driver di accesso ai dati anche tramite il parametro Protocollo della procedura guidata. Il valore Protocollo deve corrispondere al protocollo specificato nel valore del parametro Percorso file o motivo. Esempio: Percorsi dei file XML • • • • C:\xml\report.xml o file:///C:/xml/report.xml per un file locale http://server:8080/path/report.xml per un file accessibile tramite HTTP ftp://server/percorso/ per i file accessibili mediante FTP smb://server:porta/condivisione/directory per i file accessibili mediante SMB Argomenti correlati • Percorso del file CSV 6.5.3 Esempio di documento e schema XML I seguenti esempi illustrano la struttura di un documento XML denominato clubdemo.xml e basato sullo schema clubdemo.xsd. Esempio: Documento clubdemo.xml <?xml version="1.0" encoding="UTF-8"?> <ClubDemo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="clubdemo.xsd"> <Countries> <Country name="France"/> <Country name="US"/> </Countries> <Customers> <Customer ID="204"> <Name type="first">Christine</Name> <Name type="last">Martin</Name> <Age>25</Age> <Address>12, allee Victor Hugo</Address> <ZIP>75016</ZIP> <City>Paris</City> <Country name="France"/> <Invoice>1234</Invoice> </Customer> <Customer ID="103"> <Name type="first">Peter</Name> <Name type="last">Travis</Name> <Age>34</Age> <Address>7835 Hartford Drive</Address> <ZIP>06108</ZIP> <City>Springfield</City> <Country name="US"/> <Invoice>23204</Invoice> </Customer> <Customer ID="106"> <Name type="first">William</Name> <Name type="last">Baker</Name> <Age>64</Age> <Address>2890 Grant Avenue</Address> <ZIP>20020</ZIP> <City>Washington DC</City> <Country name="US"/> 97 2013-07-02 Riferimento per i driver di accesso ai dati <Invoice>35306</Invoice> <Invoice>44106</Invoice> </Customer> </Customers> </ClubDemo> Esempio: Schema clubdemo.xsd <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="ClubDemo"> <xs:complexType> <xs:sequence> <xs:element ref="Countries"/> <xs:element ref="Customers"/> </xs:sequence> </xs:complexType> <xs:key name="countkey"> <xs:selector xpath="Countries/Country"/> <xs:field xpath="@name"/> </xs:key> <xs:key name="custkey"> <xs:selector xpath="Customers/Customer"/> <xs:field xpath="@ID"/> </xs:key> <xs:keyref name="custkeyref" refer="countkey"> <xs:selector xpath="Customers/Customer"/> <xs:field xpath="Country/@name"/> </xs:keyref> </xs:element> <xs:element name="Countries"> <xs:complexType> <xs:sequence> <xs:element ref="Country" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Country"> <xs:complexType> <xs:attribute name="name" type="xs:string"/> </xs:complexType> </xs:element> <xs:element name="Customers"> <xs:complexType> <xs:sequence> <xs:element ref="Customer" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Customer"> <xs:complexType> <xs:sequence> <xs:element name="Name" maxOccurs="2"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:string"> <xs:attribute name="type" type="xs:string"/> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element> <xs:element name="Age" type="xs:integer"/> <xs:element name="Address" type="xs:string"/> <xs:element name="ZIP" type="xs:string"/> <xs:element name="City" type="xs:string"/> <xs:element name="Country"> <xs:complexType> <xs:attribute name="name" type="xs:string"/> </xs:complexType> </xs:element> 98 2013-07-02 Riferimento per i driver di accesso ai dati <xs:element name="Invoice" type="xs:integer" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="ID" type="xs:integer"/> </xs:complexType> </xs:element> </xs:schema> 6.5.4 Driver XML - Mappatura di più file È possibile connettersi a più file se il parametro Percorso file o motivo della procedura guidata di connessione è impostato su un motivo, ad esempio clubdemo_*.xml, che corrisponde a file quali clubdemo_1.xml e clubdemo_2.xml. Promemoria: Non è possibile connettersi a più file presenti su un server HTTP. Il protocollo HTTP non supporta l'uso di caratteri jolly nei motivi. Se nella procedura guidata di connessione viene selezionato il parametro Unisci file in uno, le tabelle identiche di più file XML vengono unite in una sola tabella. Il nome del qualificatore di tabella è il percorso completo del motivo, ad esempio C:\files\xml\clubdemo_*.xml. Si presuppone che tutti i file abbiano lo stesso schema. Se il parametro non viene selezionato, le tabelle non vengono unite poiché non appartengono allo stesso qualificatore. Ogni documento XML viene quindi mappato a un qualificatore di database. Il nome del qualificatore è il percorso completo del file XML, ad esempio C:\files\xml\clubdemo_1.xml. In questo caso, ogni file XML può avere il proprio schema. Non vengono mappati dati ai proprietari di database. 6.5.5 Driver XML - Mappatura di tabelle Il driver di accesso ai dati espone i file XML come tabelle a Information Design Tool. La radice del documento XML viene mappata a una tabella. Gli elementi con il valore maxOccurs maggiore di 1 vengono mappati a tabelle. Il nome della tabella mappata a un elemento è la concatenazione di tutti i nomi di elementi tra la radice e l'elemento, separati da una barra (/). Esempio: Il documento clubdemo.xml viene mappato alle seguenti tabelle: • 99 ClubDemo 2013-07-02 Riferimento per i driver di accesso ai dati • • • • ClubDemo/Countries/Country ClubDemo/Customers/Customer ClubDemo/Customers/Customer/Invoice ClubDemo/Customers/Customer/Name Argomenti correlati • Esempio di documento e schema XML 6.5.6 Driver XML - Mappatura di colonne I seguenti oggetti sotto un elemento XML vengono mappati a colonne della tabella che rappresenta questo elemento: • • • • Attributi Elementi simpleType o complexType con un elemento simpleContent Testi che si trovano in un elemento misto, il cui tipo cioè definisce mixed=true any e anyAttribute Se la colonna rappresenta un attributo, il suo nome è la concatenazione dei nomi di tutti gli elementi a partire dall'elemento (che però non è incluso) con maxOccurs maggiore di 1, fino all'elemento incluso che ospita l'attributo. Il nome dell'attributo viene preceduto dal prefisso @, per evitare conflitti con altri elementi. Se la colonna rappresenta un elemento, il suo nome è la concatenazione dei nomi di tutti gli elementi a partire dall'elemento (che però non è incluso) con maxOccurs maggiore di 1. Se la colonna rappresenta lo stesso elemento della relativa tabella, il suo nome corrisponderà al nome dell'elemento. Il separatore utilizzato nelle concatenazioni è la barra (/). I nomi degli elementi sono preceduti da un trattino (-) quando rappresentano elementi secondati utilizzati nei percorsi per creare chiavi esterne. I seguenti esempi di mappatura si riferiscono all'argomento sull'esempio di documento e schema XML. Esempio: La tabella ClubDemo include la seguente colonna: • -id Esempio: La tabella ClubDemo/Countries/Country include le seguenti colonne: 100 2013-07-02 Riferimento per i driver di accesso ai dati • • @name -Countries/-ClubDemo/-id Esempio: La tabella ClubDemo/Customers/Customer include le seguenti colonne: • • • • • • • Età Indirizzo ZIP Città Country/@name @ID -Customers/-ClubDemo/-id Esempio: La tabella ClubDemo/Customers/Customer/Invoice include le seguenti colonne: • • • -id Invoice -Customers/@ID Esempio: La tabella ClubDemo/Customers/Customer/Name include le seguenti colonne: • • • • -id Nome @type -Customer/@ID Nello schema XML, name, type e ID sono nomi di attributo rispettivamente degli elementi Country, Name e Customer. Le colonne Invoice e Name rappresentano rispettivamente gli elementi Invoice e Name. Vedere l'argomento sulla mappatura di chiavi primarie ed esterne per ulteriori informazioni sul significato degli altri nomi di colonna. Argomenti correlati • Esempio di documento e schema XML • Driver XML - Mappatura di chiavi primarie ed esterne • Driver XML - Mappatura di anyType e simpleType 101 2013-07-02 Riferimento per i driver di accesso ai dati 6.5.7 Driver XML - Mappatura di chiavi primarie ed esterne Chiavi primarie Le seguenti regole valgono per la mappatura di chiavi primarie: • • Il driver genera la chiave primaria della tabella che mappa l'elemento principale del documento. La colonna associata viene denominata -id e il suo valore corrisponde al nome del documento. Un attributo o un elemento di tipo "xs:ID" viene mappato a una colonna che rappresenta una chiave primaria. Se lo schema XML definisce una chiave con <xs:key>, si applicano le seguenti regole: • • Se la chiave viene definita al livello principale e il selettore contiene un elemento con un valore maxOccurs maggiore di 1, la chiave viene mappata alla chiave primaria della tabella corrispondente. Se la chiave non è definita al livello principale, la chiave primaria della tabella è costituita dalla combinazione della chiave primaria dell'elemento principale e del campo della chiave. Se lo schema non definisce una chiave primaria per un elemento selettore con un valore maxOccurs maggiore di 1, alla tabella viene aggiunta una colonna con il nome -id come chiave primaria. Esempio: Elemento principale del documento L'elemento ClubDemo è l'elemento principale del documento clubdemo.xml. La colonna -id viene creata e definita come chiave primaria della tabella ClubDemo. Il valore della colonna -id è clubde mo.xml. Esempio: Chiave esplicita La seguente chiave impostata al livello principale definisce la colonna @name della tabella ClubDe mo/Countries/Country come chiave primaria: <xs:key name="countkey"> <xs:selector xpath="Countries/Country"/> <xs:field xpath="@name"/> </xs:key> La tabella ClubDemo/Customers/Customer contiene la colonna @ID come chiave primaria, poiché lo schema definisce la chiave esplicita custkey: <xs:key name="custkey"> <xs:selector xpath="Customers/Customer"/> <xs:field xpath="@ID"/> </xs:key> Esempio: Nessuna chiave esplicita La tabella ClubDemo/Customers/Customer/Invoice contiene una colonna -id come chiave primaria, poiché lo schema non definisce una chiave per questo elemento. 102 2013-07-02 Riferimento per i driver di accesso ai dati Chiavi esterne Se lo schema XML definisce un riferimento di chiave con <xs:keyref> e il riferimento di chiave viene definito allo stesso livello della chiave a cui fa riferimento, il riferimento di chiave viene mappato a una chiave esterna della tabella corrispondente. Per ogni tabella corrispondente a un elemento diverso da quello principale, la chiave esterna viene creata dalle colonne chiave primaria della relativa tabella principale e dal percorso inverso dall'elemento al relativo elemento principale. Ciò consente la mappatura delle relazioni tra gli elementi principali e secondari. Limitazione: Sebbene le basi dati espongano chiavi esterne, il driver XML non supporta operazioni JOIN. Esempio: Keyref La tabella ClubDemo/Customers/Customer prevede le seguenti chiavi esterne: • Country/@name, che corrisponde al nome del seguente keyref: <xs:keyref name="custkeyref" refer="countkey"> <xs:selector xpath="Customers/Customer"/> <xs:field xpath="Country/@name"/> </xs:keyref> • Si noti che countkey è la chiave esplicita definita per una tabella diversa da quella principale. -Customers/-ClubDemo/-id, che viene creata dal percorso inverso della tabella principale e dalla chiave primaria della tabella principale Esempio: Nessun keyref La tabella ClubDemo/Customers/Customer/Invoice include una colonna -Customer/@ID definita come chiave esterna, che è costituita dalla colonna chiave primaria della tabella principale e dal percorso inverso della tabella principale. Argomenti correlati • Esempio di documento e schema XML • Driver XML - Mappatura di colonne 6.5.8 Driver XML - Mappatura di elementi misti L'intero contenuto di un elemento misto viene mappato a una colonna di tabella, inclusi gli elementi secondari e tutti i dati presenti tra di essi. Gli attributi di un elemento misto vengono mappati a colonne, indipendentemente dal modo in cui l'elemento viene mappato. 103 2013-07-02 Riferimento per i driver di accesso ai dati Esempio: In questo esempio, l'elemento documentation prevede un complexType costituito da tre elementi secondari (name, datatype e location). <documentation> The <name>XML driver</name> allows you to retrieve <datatype>XML</datatype> data from documents located on a <location>remote server</location>. </documentation> Il livello di accesso ai dati mappa tali elementi come riportato di seguito: • • L'elemento documentation viene mappato a una colonna di tabella. I contenuti dell'elemento documentation diventano i dati della colonna, inclusi gli elementi secondari e tutti i dati presenti tra di essi. Nell'esempio, la colonna contiene la seguente riga: The <name>XML driver</name> allows you to retrieve <datatype>XML</datatype> data from documents located on a <location>remote server</location>. 6.5.9 Driver XML - Mappatura di elementi ricorsivi Il seguente schema definisce elementi ricorsivi: <xs:element name="parent"> <xs:complexType> <xs:sequence> <xs:element ref="child" minOccurs="0" maxOccurs="5"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="child"> <xs:complexType> <xs:sequence> <xs:element ref="parent" minOccurs="0" maxOccurs="2"/> </xs:sequence> </xs:complexType> </xs:element> Il driver XML mappa il primo elemento parent e l'elemento child alle tabelle e ignora l'elemento secondario di parent. 6.5.10 Driver XML - Mappatura di any e anyAttribute Esempio: Schema XSD con any <xs:element name="documentation"> <xs:complexType> <xs:sequence> <xs:element name="name" type="xs:string"/> <xs:element name="datatype" type="xs:string"/> <xs:any minOccurs="0" maxOccurs="1"/> 104 2013-07-02 Riferimento per i driver di accesso ai dati </xs:sequence> </xs:complexType> </xs:element> • • Gli elementi name e datatype vengono mappati a colonne L'elemento any viene mappato alla colonna -any Esempio: File XML con any <documentation> <name>Data Access Guide</name> <datatype>XML</datatype> <audience> <type>External</type> <name>Administrator</name> </audience> </documentation> I dati della colonna -any corrispondono al nome dell'elemento e al relativo contenuto. Nell'esempio, contengono la seguente riga: <audience><type>External</type><name>Administrator</name></audience> Limitazione: Se l'elemento any prevede un valore maxOccurs maggiore di 1, il driver XML mappa alla colonna -any solo il primo nome di elemento rilevato durante l'analisi del documento XML. Gli altri nomi di elemento vengono ignorati. Nel seguente esempio, <format>PDF</format> viene ignorato. <documentation> <name>Data Access Guide</name> <datatype>XML</datatype> <audience> <type>External</type> <name>Administrator</name> </audience> <format>PDF</format> </documentation> Esempio: Schema XSD con anyAttribute <xs:element name="documentation"> <xs:complexType> <xs:sequence> <xs:element name="name" type="xs:string"/> <xs:element name="datatype" type="xs:string"/> </xs:sequence> <xs:anyAttribute/> </xs:complexType> </xs:element> • • Gli elementi name e datatype vengono mappati a colonne L'elemento anyAttribute viene mappato alla colonna -@anyAttribute Esempio: File XML con anyAttribute <documentation myAttribute="ConnectionServer"> <name>Data Access Guide</name> <datatype>XML</datatype> </documentation> <documentation myAttribute="DataFederator"> 105 2013-07-02 Riferimento per i driver di accesso ai dati <name>Data Federator User Guide</name> <datatype>any</datatype> </documentation> I dati della colonna -@anyAttribute corrispondono al nome dell'attributo dell'elemento e al relativo valore. Nell'esempio, i dati della colonna contengono le seguenti due righe: myAttribute="ConnectionServer" myAttribute="DataFederator" 6.5.11 Driver XML - Mappatura di anyType e simpleType Nelle seguenti sezioni viene illustrato come vengono mappati anyType e specifiche disposizioni di simpleType negli schemi XML. Mappatura di tipo anyType L'intero contenuto di un elemento di tipo anyType viene mappato a una colonna di tabella. Esempio: anyType Nell'esempio Club Demo, il seguente elemento Address viene mappato alla colonna Address. <xs:element name"Address" type="xs:anyType"/> Mappatura di elenchi di valori Indipendentemente dal tipo di dati di base del valore, un elenco di valori viene sempre mappato a VARCHAR. Esempio: Elenco di tipo di dati Il tipo di dati di base è un valore intero. Il tipo di dati dell'elenco di valori interi è VARCHAR. <intvalues>100 34 56 -23 1567</intvalues> Mappatura di restrizioni a un tipo Il valore di un elemento può essere limitato a un determinato intervallo. Ciò non incide sulla conversione del tipo di dati. Esempio: Restrizione <xs:element name="age"> <xs:simpleType> <xs:restriction base="xs:integer"> <xs:minInclusive value="0"/> <xs:maxInclusive value="100"/> </xs:restriction> </xs:simpleType> </xs:element> 106 2013-07-02 Riferimento per i driver di accesso ai dati Mappatura di unioni di tipi Il tipo di dati XML a cui viene mappata l'unione è una stringa, corrispondente cioè ai tipi di dati CHAR o VARCHAR nelle basi dati. Esempio: Unione di tipi <xs:element name="jeans_size"> <xs:simpleType> <xs:union memberTypes="xs:string xs:int"/> </xs:simpleType> </xs:element> 6.5.12 Driver XML - Configurazione della dimensione massima delle colonne Il file di configurazione cs.cfg fornisce i seguenti parametri: • • • Binary Max Length, per impostare la dimensione massima delle colonne di tabella di tipo binario Integer Max Length, per impostare la dimensione massima delle colonne di tabella di tipo integer, nonPositiveInteger, negativeInteger, noNegativeInteger e positiveInteger String Max Length, per impostare la dimensione massima delle colonne di tabella di tipo stringa o di uno qualsiasi dei tipi seguenti: anyURI, QName, NOTATION, duration, gYearMonth, gYear, gMonthDay, gDay, gMonth, TYPE_NORMALIZEDSTRING, token, language, Name, NCName, XSD_TYPE_ID, IDREF, IDREFS, ENTITY, ENTITIES Argomenti correlati • Binary Max Length • Integer Max Length • Lunghezza massima 6.6 Driver di servizio Web Il livello di accesso ai dati consente alla piattaforma BI di connettersi ai servizi disponibili in Internet tramite HTTP o FTP. Fornisce un driver di accesso ai dati denominato driver di servizio Web, per comunicare con i servizi Web tramite messaggi SOAP 1.1. I servizi Web sono definiti in documenti che descrivono tipi di dati, messaggi e collegamenti con il linguaggio WSDL (Web Services Description Language) 1.1. Il driver di servizio Web supporta servizi Web di collegamento SOAP 1.1 e stile document o rpc con corpo literal. Ad esempio: <wsdl:operation ...> <soap:operation ... style="document"/> 107 2013-07-02 Riferimento per i driver di accesso ai dati <wsdl:input> <soap:body use="literal"/> </wsdl:input> ... </wsdl:operation> oppure <wsdl:operation ...> <soap:operation ... style="rpc"/> <wsdl:input> <soap:body use="literal"/> </wsdl:input> ... </wsdl:operation> Promemoria: Il driver non supporta altre versioni del protocollo SOAP e servizi di stili diversi da document e rpc. La procedura guidata di connessione offre un workflow per l'inserimento delle informazioni necessarie per connettersi a servizi Web. I servizi Web vengono visualizzati nel DBMS Web Services (WSDL 1.1) e nel livello di rete Web Services Connector. È possibile reperire i file di configurazione del driver nella directory dir-installazione-connec tionserver\connectionServer\xml. Il file xml.prm elenca le funzionalità del driver di accesso ai dati in termini di operazioni e funzioni di database. 6.6.1 Funzionalità del driver di servizio Web I driver XML e di servizio Web condividono le stesse funzionalità. Argomenti correlati • Funzionalità del driver XML 6.6.2 Posizione del servizio Web La posizione del servizio Web viene impostata utilizzando il parametro URL servizio Web nella procedura guidata di connessione, con le seguenti informazioni: • • • Nome utente e password, se necessari per l'autenticazione Indirizzo del server proxy Nome utente e password del proxy, se necessari per l'autenticazione La presente versione supporta anche i protocolli crittografati HTTPS e FTPS basati su un certificato. Promemoria: Il driver di servizio Web supporta solo il documento di definizione del servizio Web e i servizi associati ospitati sullo stesso server HTTP. 108 2013-07-02 Riferimento per i driver di accesso ai dati Esempio: http://wsf.cdyne.com/WeatherWS/Weather.asmx?WSDL 6.6.3 Esempio di definizione di servizio Web Il seguente esempio illustra il documento ClubDemo.wsdl, che definisce il servizio Web CustomerService di stile document. L'URL di esempio di questo servizio Web è http://ws.myexa mple.com/ClubDemo/ClubDemo.wsdl. Esempio: Il documento WSDL definisce i seguenti dettagli: • • • • • • • Il servizio CustomerService La porta Customer Il collegamento GetCustomer Il portType CustomerType L'operazione GetCustomerList Il messaggio di input GetCustomerListByCountryRequest, che contiene l'elemento Country Il messaggio di output GetCustomerListByCountryResponse, che contiene l'elemento Get CustomerListReturn del tipo complesso Customer <wsdl:definitions targetNamespace="http://ws.myexample.com/ClubDemo/" xmlns:apachesoap="http://xml.apache.org/xml-soap" xmlns:impl="http://ws.myexample.com/ClubDemo/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"> <wsdl:types> <schema targetNamespace="http://ws.myexample.com/ClubDemo/"> <complexType name="Customer"> <sequence> <element name="Name" maxOccurs="2"> <complexType> <simpleContent> <extension base="xsd:string"> <attribute name="type" type="xsd:string"/> </extension> </simpleContent> </complexType> </element> <element name="Age" type="xsd:integer"/> <element name="Address" type="xsd:string"/> <element name="ZIP" type="xsd:string"/> <element name="City" type="xsd:string"/> <element name="Country"> <complexType> <attribute name="name" type="xsd:string"/> </complexType> </element> <element name="Invoice" type="xsd:integer" maxOccurs="unbounded"/> </sequence> <attribute name="ID" type="xsd:integer"/> </complexType> 109 2013-07-02 Riferimento per i driver di accesso ai dati <element name="GetCustomerListByCountry"> <element name="Country"> <complexType> <attribute name="name" type="xsd:string"/> </complexType> </element> </element> <element name="GetCustomerListResponse"> <complexType> <sequence> <element name="GetCustomerListReturn" type="impl:Customer" maxOccurs="unbounded"/> </sequence> </complexType> <key name="custkey"> <selector xpath="GetCustomerListReturn"/> <field xpath="@ID"/> </key> </element> </schema> </wsdl:types> <wsdl:message name="GetCustomerListByCountryRequest"> <wsdl:part name="request" element="impl:GetCustomerListByCountry"></wsdl:part> </wsdl:message> <wsdl:message name="GetCustomerListByCountryResponse"> <wsdl:part name="response" element="impl:GetCustomerListResponse"></wsdl:part> </wsdl:message> <wsdl:portType name="CustomerType"> <wsdl:operation name="GetCustomerList"> <wsdl:documentation>Gets Information on ClubDemo Customers</wsdl:documentation> <wsdl:input message="impl:GetCustomerListByCountryRequest"/> <wsdl:output message="impl:GetCustomerListByCountryResponse"/> </wsdl:operation> </wsdl:portType> <wsdl:binding name="GetCustomer" type="impl:CustomerType"> <soap:binding transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="GetCustomerList"> <soap:operation soapAction="http://ws.myexample.com/ClubDemo/" style="document"/> <wsdl:input> <soap:body use="literal"/> </wsdl:input> <wsdl:output> <soap:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="CustomerService"> <wsdl:port name="Customer" binding="impl:GetCustomer"> <soap:address location="http://ws.myexample.com/ClubDemo/"/> </wsdl:port> </wsdl:service> </wsdl:definitions> 6.6.4 Regole di mappatura per i servizi Web Il driver di servizio Web utilizza le stesse regole di mappatura di tabelle e colonne del driver XML. Il driver supporta anche le seguenti regole specifiche per i servizi Web. 110 2013-07-02 Riferimento per i driver di accesso ai dati Qualificatori Il livello di accesso ai dati può connettersi a un solo servizio Web alla volta. Il servizio viene mappato al qualificatore di database. Nell'esempio ClubDemo, il nome del qualificatore è il nome di servizio Cu stomerService. Proprietari L'attributo port viene mappato al proprietario del database. Nell'esempio, il proprietario è Customer. Tabelle Nel livello di accesso ai dati, ogni operazione viene rappresentata come un elemento principale. Ogni messaggio di output rappresenta un elemento secondario di un'operazione. Il driver di servizio Web espone i messaggi di output come tabelle. I nomi di tabella sono la concatenazione dei nomi dell'operazione, del messaggio di output e degli elementi XML contenuti nella risposta, separati da una barra (/). Esempio: Nell'esempio ClubDemo le tabelle sono le seguenti: • • • • GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListResponse GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListRespo nse/GetCustomerListReturn GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListRespo nse/GetCustomerListReturn/Name GetCustomerList/GetCustomerListByCountryResponse/GetCustomerListRespo nse/GetCustomerListReturn/Invoice Colonne e colonne di input Le regole di mappatura XML per le colonne si applicano anche ai servizi Web. Il driver di servizio Web accetta come messaggi di input solo tabelle con una singola riga. Ogni voce della tabella in questione viene mappata a una colonna di input della tabella risultante. Il driver mappa tutti i messaggi di input, anche se sono definiti come opzionali nel documento WSDL. Limitazione: Il driver non supporta any e anyAttribute nelle colonne di input. Negli esempi seguenti, la colonna GetCustomerListByCountryRequest/GetCustomerListBy Country è una colonna di input. Gli altri nomi di colonne vengono prodotti dalle regole di mappatura degli elementi XML. Per ulteriori informazioni, consultare la sezione sui driver XML. Esempio: Le colonne della tabella GetCustomerList/GetCustomerListByCountryResponse/GetCus tomerListResponse sono le seguenti: • • 111 -id GetCustomerListByCountryRequest/GetCustomerListByCountry 2013-07-02 Riferimento per i driver di accesso ai dati Esempio: Le colonne della tabella GetCustomerList/GetCustomerListByCountryResponse/GetCus tomerListResponse/GetCustomerListReturn sono le seguenti: • • • • • • • • Età Indirizzo ZIP Città Country/@name @ID -GetCustomerListResponse/-id GetCustomerListByCountryRequest/GetCustomerListByCountry Esempio: Le colonne della tabella GetCustomerList/GetCustomerListByCountryResponse/GetCus tomerListResponse/GetCustomerListReturn/Name sono le seguenti: • • • • • -id Nome @type -GetCustomerListReturn/@ID GetCustomerListByCountryRequest/GetCustomerListByCountry Esempio: Le colonne della tabella GetCustomerList/GetCustomerListByCountryResponse/GetCus tomerListResponse/GetCustomerListReturn/Invoice sono le seguenti: • • • • -id Invoice -GetCustomerListReturn/@ID GetCustomerListByCountryRequest/GetCustomerListByCountry Chiavi primarie ed esterne Le regole di mappatura XML per le chiavi primarie ed esterne si applicano anche ai servizi Web. Inoltre, una colonna di input fa sempre parte della definizione di una chiave primaria. Limitazione: Sebbene le basi dati espongano chiavi esterne, il driver di servizio Web non supporta operazioni JOIN. Esempio: Chiavi primarie La colonna -id della tabella GetCustomerList/GetCustomerListByCountryResponse/Get CustomerListResponse viene generata perché lo schema non definisce alcuna chiave primaria. 112 2013-07-02 Riferimento per i driver di accesso ai dati Lo schema definisce una chiave primaria esplicita per la colonna @ID della tabella GetCustomerLi st/GetCustomerListByCountryResponse/GetCustomerListResponse/GetCustomerLis tReturn. La colonna di input GetCustomerListByCountryRequest/GetCustomerListByCountry viene utilizzata come chiave primaria. Esempio: Chiavi esterne Le colonne -GetCustomerListResponse/@ID e -GetCustomerListReturn/@ID vengono create dal percorso inverso della tabella principale e dalla chiave primaria della tabella principale. Tipi di dati matrice I servizi Web supportano tipi di dati nel formato di una matrice costituita da una serie di tipi primitivi e complessi. Un elemento d questo tipo viene mappato a una tabella di una sola riga. Viene mappato come parte di nomi di colonna o tabella come -arrayElement. Il tipo di dati matrice non definisce il nome dell'elemento e accetta qualsiasi nome. Per ulteriori informazioni sui tipi di dati matrice, vedere il collegamento in basso. Esempio: Tipi di dati matrice arrayType="xsd:int[2]" è un tipi di dati di un elemento che ha due occorrenze e il cui valore è un numero intero. Ad esempio, il seguente tipo complesso si applica all'elemento CustomerIDs e lo definisce come elemento principale di un elemento CustomerID che accetta valori interi: <complexType name="ArrayOfIntegers"> <complexContent> <restriction base="soapenc:Array"> <attribute ref="soapenc:arrayType" wsdl:arrayType="xsd:int[2]"/> </restriction> </complexContent> </complexType> <element name="CustomerIDs" type="ArrayOfIntegers"> <CustomerID>103</CustomerID> <CustomerID>204</CustomerID> </element> Argomenti correlati • Details on arrays in SOAP 1.1 note • Driver XML - Mappatura di colonne • Driver XML - Mappatura di chiavi primarie ed esterne 6.6.5 Driver di servizio Web - Configurazione della dimensione massima delle colonne 113 2013-07-02 Riferimento per i driver di accesso ai dati Come il driver XML, anche il driver di servizio Web utilizza i parametri Binary Max Length, Integer Max Length e String Max Length nel file cs.cfg per gestire valori elevati di questi tipi di dati. Argomenti correlati • Binary Max Length • Integer Max Length • Lunghezza massima 6.7 Disco locale utilizzato come cache per le operazioni di ordinamento Il CSV OpenDriver e i driver OData, SAP ERP, XML e di servizio Web possono utilizzare il disco locale come cache per le righe ordinate. I driver di accesso ai dati eseguono le operazioni di ordinamento (ORDER BY, GROUP BY e DISTINCT) come indicato di seguito: • • Nella memoria principale, se c'è una piccola quantità di dati da ordinare Scrivendo i dati in una directory temporanea sul disco locale Le righe ordinate vengono scritte sul disco quando la memoria principale disponibile è insufficiente o quando viene raggiunto il numero di righe definite utilizzando il parametro SBO Bucket Split Size. Il disco locale viene utilizzato come cache e i dati vengono scritti nella cartella temporanea predefinita del computer. È possibile configurare il percorso della directory nel file cs.cfg con il parametro Temp Data Dir quando nel sistema operativo non è specificata alcuna cartella temporanea. Argomenti correlati • CSV OpenDriver • Driver OData • Driver SAP ERP • Driver XML • Driver di servizio Web • Bucket Split Size • Temp Data Dir 114 2013-07-02 Riferimenti alle connessioni Riferimenti alle connessioni 7.1 Connessioni HIVE Il livello di accesso ai dati consente alla piattaforma BI di connettersi ai database Apache Hadoop HIVE 0.7.1, 0.8.0 e 0.9.0 e al database Amazon Elastic MapReduce (EMR) HIVE tramite JDBC su tutte le piattaforme. Per creare una connessione al server Apache Hive Thrift, è necessario innanzitutto posizionare i seguenti insiemi di file JAR nella directory dir-installazione-connectionserver\connectio nServer\jdbc\drivers\hive: Versione del database Apache Hadoop HIVE File JAR hadoop-0.20.1-core.jar o hadoop-core-0.20.2.jar hive-exec-0.7.1.jar hive-jdbc-0.7.1.jar hive-metastore-0.7.1.jar hive-service-0.7.1.jar 0.7.1 libfb303.jar log4j-1.2.16.jar commons-logging-1.0.4.jar slf4j-api-1.6.1.jar slf4j-log4j12-1.6.1.jar 115 2013-07-02 Riferimenti alle connessioni Versione del database Apache Hadoop HIVE File JAR hadoop-0.20.1-core.jar o hadoop-core-0.20.2.jar hive-exec-0.8.0.jar hive-jdbc-0.8.0.jar hive-metastore-0.8.0.jar hive-service-0.8.0.jar 0.8.0 libfb303.jar log4j-1.2.16.jar commons-logging-1.0.4.jar slf4j-api-1.6.1.jar slf4j-log4j12-1.6.1.jar hadoop-0.20.1-core.jar o hadoop-core-0.20.2.jar hive-exec-0.9.0.jar hive-jdbc-0.9.0.jar hive-metastore-0.9.0.jar hive-service-0.9.0.jar 0.9.0 libfb303.jar log4j-1.2.16.jar commons-logging-1.0.4.jar slf4j-api-1.6.1.jar slf4j-log4j12-1.6.1.jar 7.1.1 Creazione di una connessione ad Amazon EMR HIVE 1. Impostare un tunnel SSH per il nodo principale Amazon. Per ulteriori informazioni, consultare la documentazione relativa ad Amazon. 116 2013-07-02 Riferimenti alle connessioni 2. Scaricare i file JAR necessari dal sito Web Amazon e posizionarli nella directory dir-installa zione-connectionserver\connectionServer\jdbc\drivers\hive. 3. Nella procedura guidata di connessione specificare host locale per il server e 10002 per la porta nel campo Server (host:porta). È stata creata una connessione al database Amazon EMR HIVE. Argomenti correlati • Creating an SSH tunnel to the master node • HIVE 0.7.1 JAR file download website • HIVE 0.8.1 JAR file download website 7.2 Connessioni IBM DB2 Limitazione: a causa di una restrizione del driver di database, i nomi delle chiavi di riferimento di IBM DB2 10 per le tabelle di database z/OS sono mappati a NULL. 7.3 Connessioni IBM Informix Nelle seguenti sezioni vengono descritte le azioni da eseguire quando si verificano problemi con le connessioni IBM Informix. Argomenti correlati • Problema con i valori data in caso di fusi orari diversi • Errore di connessione in caso di mancato supporto della modalità transazione 7.3.1 Problema con i valori data in caso di fusi orari diversi In Information Design Tool, le query su IBM Informix Dynamic Server 11 eseguite mediante JDBC possono restituire valori di tipo data errati se lo strumento client e il server si trovano in fusi orari diversi. Per evitare il problema, è necessario impostare il valore del fuso orario della JVM sullo stesso fuso orario impostato a livello del server di database. 1. Chiudere Information Design Tool. 117 2013-07-02 Riferimenti alle connessioni 2. Accedere alla directory dir-installazione-bip\win32_x86. 3. Aprire il file InformationDesignTool.ini per la modifica. 4. Aggiungere la riga seguente alla fine del file: -Duser.timezone=server_timezone_value in cui server_timezone_value è il valore di fuso orario impostato sul server di database. Ad esempio: GMT. 5. Salvare il file. 6. Riavviare l'applicazione. Quando si completa questa attività, le connessioni a un database IBM Informix stabilite mediante JDBC vengono configurate correttamente. 7.3.2 Errore di connessione in caso di mancato supporto della modalità transazione Il livello di accesso ai dati consente di eseguire operazioni SQL come blocco di transazioni per impostazione predefinita. Informix Dynamic Server non supporta transazioni, possono quindi verificarsi errori di connessione. Per evitare il problema, nel file di configurazione del driver specificare che la modalità transazione non è disponibile. 1. Chiudere lo strumento client. 2. Aprire il file informix.sbo per la modifica. Si trova nella directory dir-installazione-connectionserver\connectionServer\jdbc. 3. Aggiungere la riga seguente alla sezione Database appropriata: <Parameter Name="Transactional Available">No</Parameter> 4. Salvare il file. 5. Riavviare il servizio e l'applicazione. Dopo avere completato questa attività, le connessioni a IBM Informix sono configurate correttamente. Argomenti correlati • Transactional Available 7.4 Connessioni MS Analysis Services Avvertenza: Le connessioni a MS Analysis Services mediante XMLA non utilizzano Connection Server. Questa sezione è relativa solo alle connessioni create in Information Design Tool. 118 2013-07-02 Riferimenti alle connessioni In Information Design Tool, gli utenti possono creare le connessioni a MS Analysis Services su HTTP mediante un driver XMLA. Per configurare queste connessioni, è necessario prima abilitare l'accesso HTTP. Per ulteriori informazioni, fare riferimento al sito Web Microsoft TechNet. Argomenti correlati • http://technet.microsoft.com/en-us/library/cc917711.aspx • http://technet.microsoft.com/en-us/library/cc917712.aspx 7.5 Connessioni Oracle Le connessioni ai cluster di server Oracle che operano in modalità failover sono supportate tramite JDBC. Il driver seleziona uno di questi server e, se non è disponibile, viene utilizzato il server successivo. Si verifica un errore di connessione se nessun server è disponibile. Nella procedura guidata di connessione, immettere l'host e la porta server separandoli con i due punti in Server (host:porta{,host:porta}) per creare una connessione JDBC. Immettere informazioni per uno o più server, se si desidera sfruttare il meccanismo di failover. 7.6 Connessioni Oracle EBS Il livello di accesso ai dati fornisce un nuovo driver per la connessione delle applicazioni SAP BusinessObjects a Oracle E-Business Suite (EBS) tramite Oracle Call Interface (OCI). Consente alle applicazioni di accedere ai dati dalle viste e dalle stored procedure di EBS. Per connettere il driver a Oracle EBS, è possibile utilizzare solo OCI. Quando si crea una connessione in Universe Design Tool o Information Design Tool, è necessario per prima cosa scegliere la modalità di autenticazione, che può essere fornita dall'utente, se l'utente dell'applicazione inserisce nome utente e password quando accede alla piattaforma BI, o mediante Single Sign On, se l'utente accede con le credenziali di Oracle EBS. Quindi si seleziona l'applicazione Oracle EBS, il gruppo di protezione e responsabilità, che definisce l'origine dati del proprio universo. La piattaforma BI fornisce SSO per Oracle EBS con l'ausilio di un plugin di autenticazione. SSO viene abilitato se il plug-in è installato e configurato correttamente. SSO consente all'utente dell'applicazione di accedere a BI Launch Pad con le credenziali di Oracle EBS. Le stesse credenziali vengono usate da Connection Server per accedere all'origine dati di Oracle EBS. Per maggiori informazioni sul plugin di autenticazione, fare riferimento al Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. 119 2013-07-02 Riferimenti alle connessioni 7.7 Connessioni Oracle Essbase Avvertenza: A causa di una restrizione nel middleware Essbase per gli universi .unv, è necessaria una distribuzione specifica del server della piattaforma BI per supportare sia gli universi .unv che gli universi .unx basati su Essbase. Per distribuire un server che supporti gli universi .unv e .unx Essbase, configurare un sistema con i seguenti due cluster su due computer diversi: • • In un ambiente a 64 bit, installare il software seguente nel primo cluster (Cluster1): la piattaforma BI a 64 bit, Central Management Server, i server Web Intelligence, un'istanza di Connection Server a 64 bit e tutti i driver middleware a 64 bit. In un ambiente a 32 bit, installare il software seguente nel secondo cluster (Cluster2): l'istanza di Connection Server a 32 bit e i driver middleware a 32 bit(incluso il driver Essbase a 32 bit per gli universi .unv). In fase di esecuzione, Connection Server utilizza Cluster2 per gli universi .unv. OLAP Client, che gestisce gli universi .unx, utilizza il middleware a 64 bit disponibile in Cluster1. 7.8 Connessioni Oracle RAC Il livello di accesso ai dati consente alla piattaforma BI di connettersi a Oracle RAC (Real Application Clusters) attraverso JDBC. Per creare una connessione dall'applicazione in uso utilizzando la procedura guidata di connessione, è necessario specificare la voce corrispondente all'origine dati Oracle RAC che presenta il seguente formato: <host>:<port>,<host>:<port>,...,<host>:<port> Il numero di host e porte dipende dal numero di computer facenti parte del cluster. Esempio: pmrac1.us.oracle.com:1521,pmrac2.us.oracle.com:1521 7.9 Connessioni salesforce.com 120 2013-07-02 Riferimenti alle connessioni È necessario prima configurare l'ambiente per fare in modo che le connessioni salesforce.com funzionino in Universe Design Tool o in Information Design Tool. 1. Arrestare il Servizio di connettività dalla CMC e l'applicazione client. 2. Eseguire regedit.exe nella riga di comando di MS Windows per aprire l'editor del Registro di sistema. 3. Andare all'origine dati Salesforce ODBC in HKEY_LOCAL_MACHINE > SOFTWARE > ODBC > ODBC.INI > <NOME_DSN_SALESFORCE>, dove NOME_DSN_SALESFORCE è il nome dell'origine dati salesforce.com. 4. Fare clic con il pulsante destro del mouse sul nome dell'origine dati e scegliere Nuovo > Valore stringa. 5. Immettere CheckJVMChanged. 6. Fare doppio clic sulla proprietà e immettere 0. 7. Chiudere l'editor del Registro di sistema. Per completare la configurazione, seguire la procedura indicata di seguito. Argomenti correlati • Procedura per consentire il funzionamento delle connessioni salesforce.com in Information Design Tool • Per fare in modo che le connessioni salesforce.com funzionino con Universe Design Tool 7.9.1 Procedura per consentire il funzionamento delle connessioni salesforce.com in Information Design Tool 1. Chiudere Information Design Tool. 2. Copiare il file driver sforce.jar nella directory dir-installazionebip\win32_x86\jdk\jre6\lib\ext. 3. Accedere alla directory dir-installazione-bip\win32_x86. 4. Aprire il file InformationDesignTool.ini per la modifica. 5. Aggiungere la riga seguente alla fine del file: -Dosgi.parentClassloader=ext 6. Salvare il file. 7. Riavviare l'applicazione. Dopo avere completato questa attività, le connessioni a salesforce.com sono configurate correttamente. 121 2013-07-02 Riferimenti alle connessioni 7.9.2 Per fare in modo che le connessioni salesforce.com funzionino con Universe Design Tool 1. Chiudere Universe Design Tool. 2. Aprire il file cs.cfg per la modifica. 3. Nella sezione JavaVM aggiungere il percorso seguente: <ClassPath> <Path>C:\Program Files (x86)\Progress\DataDirect\Connect_for_ODBC_61\java\lib\sforce.jar</Path> </ClassPath> 4. Salvare il file. 5. Aprire il file openaccess.sbo per la modifica. Si trova nella directory dir-installazione-connectionserver\connectionServer\odbc. 6. Aggiungere la riga seguente alla sezione Database: <Parameter Name="Transactional Available">No</Parameter> 7. Salvare il file. 8. Riavviare il servizio e l'applicazione. Dopo avere completato questa attività, le connessioni a salesforce.com sono configurate correttamente. Argomenti correlati • Transactional Available 7.10 Connessioni SAP HANA Il livello di accesso ai dati consente alla piattaforma BI di connettersi al database SAP HANA 1.0 mediante ODBC e JDBC su tutte le piattaforme. La presente versione supporta anche connessioni OLAP al database SAP HANA su MS Windows, Linux e AIX. Dimensioni array fetch Il valore predefinito di Dimensioni array fetch è 1000 per le connessioni SAP HANA. Avvertenza: poiché un valore elevato di Dimensioni array fetch comporta una maggiore necessità di memoria, questa configurazione può incidere sulle prestazioni del sistema. 122 2013-07-02 Riferimenti alle connessioni Failover Le connessioni ai cluster di server SAP HANA che operano in modalità failover sono supportate tramite ODBC e JDBC. Il driver seleziona uno di questi server e, se non è disponibile, viene utilizzato il server successivo. Si verifica un errore di connessione se nessun server è disponibile. Impostazioni internazionali di visualizzazione preferite La connettività SAP HANA supporta le impostazioni internazionali di visualizzazione preferite per tutte le modalità di autenticazione tramite ODBC e JDBC. Tali impostazioni consentono all'utente di recuperare i dati localizzati se il database archivia i dati in diverse lingue. Single Sign-On al database La piattaforma BI assicura il Single Sign On (SSO) al database utilizzando Windows AD con Kerberos o il protocollo SAML sulle piattaforme MS Windows e Linux. Il servizio SSO con Kerberos è disponibile per le connessioni JDBC e ODBC. Il servizio SSO con SAML è disponibile in JDBC, ma non in ODBC. Se nell'ambiente sono disponibili entrambe le implementazioni Kerberos e SAML, la piattaforma utilizzerà prioritariamente SAML. Se si verificano problemi con SAML, la piattaforma utilizzerà Kerberos. Questa logica è invisibile all'utente dell'applicazione. Per disattivare l'uso di SAML, impostare il parametro Skip SAML SSO su True nel file di configurazione newdb.sbo appropriato. La piattaforma BI assicura anche l'SSO al database mediante Windows AD con Kerberos o il protocollo SAML nelle connessioni OLAP. Quando gli utenti hanno eseguito l'accesso alla piattaforma BI da un'applicazione SAP BusinessObjects, possono eseguire azioni che richiedono l'accesso al database, quale l'aggiornamento dei documenti Web Intelligence, senza fornire le credenziali per il database. Supporto di UNIX A partire dalla versione 4.1, il livello di accesso ai dati consente alla piattaforma BI di connettersi al database SAP HANA tramite ODBC sulle piattaforme UNIX a 64 bit. Utilizzo di SSL Le connessioni a SAP HANA tramite ODBC, JDBC o OLAP possono utilizzare il protocollo SSL. Argomenti correlati • Skip SAML SSO 7.10.1 Creazione di una connessione SAP HANA Creazione di una connessione JDBC I driver JDBC SAP HANA 1.0 SPS 05 vengono installati come parte della piattaforma BI nella directory dir-installazione-connectionServer\connectionServer\jdbc\drivers\newdb. Di conseguenza, non è necessario eseguire altre operazioni di configurazione per creare una connessione a un database SAP HANA. 123 2013-07-02 Riferimenti alle connessioni Selezionare una delle seguenti opzioni nella procedura guidata di connessione per creare una connessione JDBC: • Server singolo Immettere il nome host e il numero di istanza HANA nei campi Nome host e Numero istanza. • Server multipli (failover) Specificare host e porta server, separandoli con i due punti, in Server (host:porta{;host:porta}). Immettere informazioni per uno o più server, se si desidera sfruttare il meccanismo di failover. La convenzione per il numero della porta è la seguente: 3##15 in cui ## è il numero di istanza HANA. Esempio: Se ci si sta connettendo all'istanza 0, digitare il numero di istanza 00 o il numero di porta 30015 nella procedura guidata. Se ci si sta connettendo all'istanza 1, digitare il numero di istanza 01 o il numero di porta 30115. Utilizzo di SSL Selezionare Utilizza SSL nella procedura guidata di connessione, per creare una connessione OLAP o JDBC che utilizzi il protocollo SSL per la connessione al server SAP HANA. Nota: Per utilizzare SSL in ODBC su MS Windows, aprire Amministrazione origine dati ODBC e selezionare SSL quando si configura il DSN. Argomenti correlati • Creazione di connessioni JDBC 7.10.2 Modifica di una connessione SAP HANA Una connessione SAP HANA aperta per la modifica può essere visualizzata in Server singolo o Server multipli (failover) nella procedura guidata di connessione. Per modificare la connessione, eseguire una delle operazioni seguenti: • • 124 Se viene visualizzata in Server singolo, modificare il nome host e il numero di istanza dell'origine dati. Se viene visualizzata in Server multipli (failover), modificare l'host e la porta server. 2013-07-02 Riferimenti alle connessioni 7.10.3 Prima di configurare il Single Sign On per le connessioni SAP HANA Promemoria: Questa sezione riguarda la configurazione del Single Sign On mediante Windows AD con Kerberos per connessioni SAP HANA. Prima di impostare le opzioni Java VM necessarie, è necessario creare i file di configurazione JAAS bscLogin.conf e Kerberos krb5.ini per preparare l'applicazione per l'autenticazione Windows AD. Per ulteriori informazioni, consultare il Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. Argomenti correlati • Configurazione del Single Sign On per Information Design Tool • Configurazione del Single Sign On per Web Intelligence • Configurazione del Single Sign On per Web Intelligence Rich Client • Prima di configurare il Single Sign On per le connessioni SAP HANA 7.10.4 Configurazione del Single Sign On per Information Design Tool La procedura seguente consente di abilitare il Single Sign On per il database SAP HANA tramite JDBC da Information Design Tool. • Eseguire una di queste operazioni: 125 2013-07-02 Riferimenti alle connessioni Opzione Descrizione Configurazione di SSO per connes- a. Chiudere Information Design Tool. sioni locali tramite JDBC b. Aprire il file InformationDesignTool.ini per la modifica. Si trova nella directorydir-installazionebip\win32_x86. c. Aggiungere le seguenti righe: -Djava.security.auth.login.config=C:\<location>\bscLogin.co nf -Djava.security.krb5.conf=C:\<location>\Krb5.ini dove <posizione> è la directory del file di configurazione nel computer in cui è in esecuzione Connection Server. d. Salvare il file. e. Riavviare Information Design Tool. Configurazione di SSO per connesL'obiettivo è di configurare il Servizio di connessione adatsioni presenti su CMS tramite JDBC tivo. a. Aprire la CMC. b. In "Servizi di connettività", arrestare il Servizio di connessione adattivo ospitato da Adaptive Processing Server. c. Passare alla pagina "Proprietà". d. Aggiungere le opzioni seguenti alla proprietà "Parametri riga di comando": -Djava.security.auth.login.config=C:\<location>\bscLogin.co nf -Djava.security.krb5.conf=C:\<location>\Krb5.ini dove <posizione> è la directory del file di configurazione nel computer in cui è in esecuzione Connection Server. e. Fare clic su Salva. f. Riavviare il servizio da CMC. Promemoria: È inoltre necessario configurare Servizio di connessione adattivo per abilitare l'SSO con Web Intelligence Rich Client in modalità connessione. questa procedura consente anche di configurare SSO per tutti gli altri servizi Java, ad esempio i servizi Data Federation. I servizi Data Federation vengono utilizzati quando si esegue una query in un universo abilitato per più origini creato su una connessione SAP HANA. 126 2013-07-02 Riferimenti alle connessioni 7.10.5 Configurazione del Single Sign On per Web Intelligence La procedura seguente consente di abilitare il Single Sign On nel database SAP HANA tramite JDBC per SAP BusinessObjects Web Intelligence. Nota: questa procedura si applica all'interfaccia Java o HTML di SAP BusinessObjects Web Intelligence che l'utente dell'applicazione avvia da BI Launch Pad. Promemoria: Questa configurazione riguarda solo i servizi di reporting di Web Intelligence ospitati dal server di elaborazione di Web Intelligence. 1. Aprire la CMC. 2. In "Servizi di Web Intelligence", arrestare il servizio di reporting ospitato dal server di elaborazione di Web Intelligence. 3. Aprire il file cs.cfg per la modifica. 4. Nella sezione JavaVM aggiungere le seguenti opzioni Java VM: <Options> <Option>-Djava.security.auth.login.config=C:\<location>\bscLogin.conf</Option> <Option>-Djava.security.krb5.conf=C:\<location>\Krb5.ini</Option> <Options> dove <posizione> è la directory del file di configurazione nel computer in cui è in esecuzione Connection Server. 5. Salvare il file. 6. Riavviare il servizio da CMC. 7.10.6 Configurazione del Single Sign On per Web Intelligence Rich Client La procedura seguente consente di abilitare il Single Sign On per il database SAP HANA tramite JDBC dall'applicazione Web Intelligence Rich Client. • Attenersi a una delle procedure seguenti: • Se ci si connette a Web Intelligence Rich Client da un documento WID o dal menu Start di Windows: a. Chiudere il documento e Web Intelligence Rich Client. b. Creare le seguenti variabili di ambiente: • java.security.auth.login.config=C:\<posizione>\bscLogin.conf • java.security.krb5.conf=C:\<posizione>\Krb5.ini dove <posizione> è la directory del file di configurazione nel computer in cui è in esecuzione Connection Server. c. Riavviare Web Intelligence Rich Client. 127 2013-07-02 Riferimenti alle connessioni • Se si utilizza Web Intelligence Rich Client in modalità connessione da BI Launch Pad (anche definita modalità HTTP), è necessario configurare il Servizio di connessione adattivo. Seguire la procedura descritta per la configurazione di Single Sign On per Information Design Tool. Argomenti correlati • Configurazione del Single Sign On per Information Design Tool 7.10.7 Configurazione di Java Virtual Machine per la strumentazione È possibile monitorare l'attività dei driver SAP HANA se si installa CA Wily Introscope con la piattaforma BI. Questa strumentazione fornisce il supporto di analisi end-to-end per le connessioni SAP HANA tramite ODBC e JDBC. L'analisi SAP HANA è abilitata per impostazione predefinita nella piattaforma. È tuttavia necessario configurare anche Java Virtual Machine per l'utilizzo del bridge JNI. 1. Aprire il file cs.cfg per la modifica. 2. Aggiungere i seguenti percorsi dei file JAR alla sezione JavaVM al fine di caricare le classi necessarie: <ClassPath> <Path>"bip-install-dir\java\lib\TraceLog.jar;bip-install-dir\java\lib\external\com.sap.js.passport.api.jar" </Path> </ClassPath> 3. Aggiungere le opzioni seguenti alla sezione JavaVM: <Options> <Option>-javaagent:bip-install-dir\java\wily\Agent.jar</Option> <Option>-Dcom.wily.introscope.agentProfile=bip-install-dir\java\wily\IntroscopeAgent_CSJNI.profile</Option> <Option>-Dcom.wily.introscope.agent.agentName=CSJNIEngine</Option> </Options> 4. Salvare il file. 5. Aprire il file IntroscopeAgent_CSJNI.profile per la modifica. Si trova nella directory dir_installazione_bip\java\wily. 6. Sostituire localhost con il nome host dell'agente Introscope nella riga seguente: introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT=localhost 7. Salvare il file. 7.11 Connessioni SAP MaxDB 128 2013-07-02 Riferimenti alle connessioni In ODBC, accertarsi di utilizzare i driver SAP MaxDB ODBC versione 7.7.07 (build 07 o successiva). SAP MaxDB fornisce driver ASCII e Unicode per MS Windows e UNIX. La versione ASCII del driver ODBC si connette sempre al kernel del database mediante ASCII. La versione Unicode del driver ODBC si connette ai kernel del database ASCII mediante ASCII e ai kernel del database Unicode mediante UCS2. SAP MaxDB non richiede una specifica gestione driver in UNIX. È tuttavia possibile configurarlo per funzionare con le seguenti gestioni driver se necessario: • • unixODBC 2.0.9 o successiva iODBC 3.0.5 o successiva In JDBC, accertarsi di utilizzare la versione più recente del driver sapdbc.jar. Per ulteriori informazioni sul driver SAP MaxDB JDBC, consultare il file di configurazione maxdb.sbo. 7.12 Connessioni SAP NetWeaver BW Avvertenza: le connessioni a SAP NetWeaver BW non utilizzano Connection Server. Queste connessioni passano attraverso un connettore dedicato e utilizzano un'interfaccia specifica in SAP NetWeaver BW. Per configurare tali connessioni, assicurarsi di utilizzare una versione compatibile di SAP NetWeaver BW. Per maggiori informazioni su come configurare e ottimizzare le connessioni a SAP NetWeaver BW, consultare il Manuale dello strumento di amministrazione di Data Federation. Per maggiori informazioni sulle autorizzazioni necessarie agli utenti di applicazioni di query e creazione di report per accedere a universi a più origini su SAP NetWeaver BW, consultare la nota SAP n. 1465871. 7.12.1 Requisiti per la connessione di Data Federator a SAP NetWeaver BW Per connettersi a SAP NetWeaver BW è necessario disporre di una versione compatibile di SAP NetWeaver BW, nonché delle Note SAP appropriate. • La versione minima richiesta è SAP NetWeaver BI 7.01 SP06. Nota: il nome ufficiale SAP NetWeaver BW è cambiato nel corso delle versioni. Prima della versione 7.3, il nome era SAP NetWeaver BI. • 129 La Nota SAP richiesta è: https://service.sap.com/sap/support/notes/1460273. 2013-07-02 Riferimenti alle connessioni Per ulteriori dettagli sulle versioni di SAP NetWeaver BW supportate, consultare il documento relativo alle piattaforme supportate per la piattaforma BI nel Support Portal. 7.13 Connessioni SAS le connessioni a SAS non utilizzano Connection Server, bensì utilizzano un connettore JDBC adattato ai set di dati SAS/SHARE. Per configurare queste connessioni, è necessario installare il driver JDBC compatibile. Per ulteriori informazioni sulla configurazione dei connettori SAS, consultare il Manuale dello strumento di amministrazione di Data Federator. 7.13.1 Installazione di driver per connessioni SAS Per poter utilizzare un connettore SAS, è necessario installare un driver che consenta al motore delle query Data Federation di connettersi a un server SAS/SHARE. Il server SAS/SHARE consente la connessione a set di dati SAS. Per ulteriori informazioni su SAS/SHARE, vedere il sito Web SAS. La directory in cui copiare i file jar del driver JDBC SAS nel computer in cui è installata la piattaforma BI è dir-installazione-boe/java/pjs/services/DataFederatorService/resources/dri vers/sas. È necessario creare le directory drivers/sas all'interno della directory resources. Per ulteriori dettagli sulle versioni SAS supportate, consultare il documento relativo alla piattaforma BI nel Support Portal. Argomenti correlati • http://www.sas.com/products/share/index.html 7.14 Connessioni Teradata Un database Teradata supporta proprietari di tabella ma non qualificatori. Connection Server restituisce l'utente corrente come proprietario corrente per le origini dati Teradata. Tuttavia, l'origine dati può essere configurata per la mappatura di un utente al database di un altro utente. In questo caso è possibile 130 2013-07-02 Riferimenti alle connessioni configurare il driver Teradata perché mappi il proprietario corrente al database con il parametro Replace Current Owner With Database. Questo parametro può essere utilizzato solo con connessioni ODBC. Argomenti correlati • Replace Current Owner With Database 131 2013-07-02 Riferimenti alle connessioni 132 2013-07-02 Creazione di una connessione al server delle query di Data Federator XI 3.0 Creazione di una connessione al server delle query di Data Federator XI 3.0 8.1 Informazioni sulle connessioni al server delle query di Data Federator XI 3.0 È possibile creare connessioni a tabelle distribuite nel server delle query di Data Federator XI 3.0 per utilizzare tali tabelle con un'applicazione SAP BusinessObjects. Questo capitolo descrive le impostazioni di configurazione da applicare al server delle query di Data Federator XI 3.0 e a Connection Server per creare delle connessioni. È possibile creare connessioni al server delle query di Data Federator XI 3.0 solo utilizzando Universe Design Tool. In questo capitolo è illustrata anche la configurazione da applicare nella procedura guidata di connessione affinché sia possibile creare le connessioni. Connessioni JDBC Non sono necessarie impostazioni aggiuntive per creare connessioni JDBC. Il driver JDBC Data Federator è in dotazione con la piattaforma SAP BusinessObjects Business Intelligence 4.0 ed è configurato affinché venga eseguito uniformemente con il server di query Data Federator XI 3.0. Connessioni ODBC Con le connessioni ODBC, la configurazione dipende dall'applicazione SAP BusinessObjects utilizzata. Il processo varia nel caso in cui venga creata una connessione da utilizzare con Web Intelligence Rich Client. Avvertenza: SAP consiglia di utilizzare una connettività JDBC per connettere le applicazioni SAP BusinessObjects al server delle query di Data Federator XI 3.0. La connettività JDBC è disponibile su tutte le piattaforme (Microsoft Windows, UNIX flavors e Linux). Il middleware ODBC Data Federator può essere utilizzato solo in Microsoft Windows e l'uso di un bridge OpenAccess ODBC-JDBC ha un certo impatto sulle prestazioni. Argomenti correlati • Configurazione della procedura guidata di connessione per una connessione JDBC o ODBC a Data Federator • Configurazione delle connessioni ODBC Data Federator • Configurazione delle connessioni Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator 133 2013-07-02 Creazione di una connessione al server delle query di Data Federator XI 3.0 8.2 Configurazione della procedura guidata di connessione per una connessione JDBC o ODBC a Data Federator Per creare una connessione al server delle query di Data Federator XI 3.0, sono necessarie le informazioni seguenti. Consultare l'amministratore di Data Federator per ottenere le informazioni seguenti: • Il nome del server e la porta su cui è in esecuzione il server Data Federator. • Il nome del catalogo in Data Federator Query Server Nella procedura guidata di connessione è possibile immettere questo nome come nome del database al quale ci sta connettendo. • I dettagli di autenticazione per l'installazione di Data Federator Query Server che serve il catalogo al quale ci si sta connettendo. Nella procedura guidata di connessione, dalla schermata Selezione del middleware del database, per creare la connessione è possibile utilizzare il middleware SAP BusinessObjects, Data Federator Server, driver JDBC o driver ODBC. Per configurare una connessione ODBC al server delle query di Data Federator XI 3.0, è necessario effettuare ulteriori operazioni di configurazione. Se si utilizza Web Intelligence Rich Client, le modifiche da apportare alla configurazione sono diverse da quelle utilizzate da altre applicazioni SAP BusinessObjects. 8.3 Configurazione delle connessioni ODBC Data Federator In questa sezione sono contenute le impostazioni aggiuntive di Data Federator XI 3.0 Query Server e le modifiche alla configurazione di Connection Server per le connessioni ODBC a tutte le applicazioni SAP BusinessObjects, ad eccezione di Web Intelligence Rich Client. I dettagli di configurazione riportati in questa sezione fanno riferimento ai seguenti percorsi: • dir-installaz-driver-data-federator\OaJdbcBridge: la directory di installazione principale del middleware ODBC Data Federator. L'amministratore sceglie questa directory al momento dell'esecuzione del programma di installazione dei driver di Data Federator. 134 • dir-installaz-driver-data-federator\JdbcDriver: la directory di installazione principale del middleware JDBC Data Federator. L'amministratore sceglie questa directory al momento dell'esecuzione del programma di installazione di Data Federator. • dir-installaz-bo: la directory di installazione principale delle applicazioni SAP BusinessObjects. 2013-07-02 Creazione di una connessione al server delle query di Data Federator XI 3.0 Nota: Modificare i file utilizzando un editor XML per essere certi che i file siano corretti. Dopo aver apportato le modifiche alla configurazione mostrate di seguito, riavviare il sistema per rendere effettive le modifiche. Argomenti correlati • Configurazione del middleware ODBC Data Federator • Configurazione di Connection Server per una connessione ODBC a Data Federator 8.3.1 Configurazione del middleware ODBC Data Federator Nota: questo argomento è valido per tutte le applicazioni SAP BusinessObjects che utilizzano Connection Server, ad eccezione di Web Intelligence Rich Client. Per configurare il middleware ODBC Data Federator, è necessario modificare il file openrda.ini. Questo file è installato nella seguente directory: • dir-installaz-driver-data-federator\OaJdbcBridge\bin\iwinnt Impostare i parametri nella sezione [JavaIp] come indicato di seguito: • CLASSPATH=dir-installaz-driver-data-federator\OaJdbcBridge\oajava\oas ql.jar;dir-installaz-driver-data-federator\JdbcDriver\thindriver.jar;dirinstallaz-bo\SAP BusinessObjects Enterprise XI 4.0\java\lib\ConnectionSer ver.jar • JVM_DLL_NAME=dir-installaz-bo\javasdk\jre\bin\client\jvm.dll • JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connectivity.directory=dirinstallaz-bo\SAP BusinessObjects Enterprise XI 4.0\dataAccess\connection Server Nota: Controllare il file openrda.ini per assicurare che questo percorso non sia impostato utilizzando il parametro Djava.endorsed.dirs. Se lo è, è necessario rimuovere il percorso dal parametro Djava.endorsed.dirs. 8.3.2 Configurazione di Connection Server per una connessione ODBC a Data Federator 135 2013-07-02 Creazione di una connessione al server delle query di Data Federator XI 3.0 Nota: questo argomento è valido per tutte le applicazioni SAP BusinessObjects che utilizzano Connection Server, ad eccezione di Web Intelligence Rich Client. Per configurare Connection Server, è necessario modificare il file di configurazione: dir-installazconnectionserver\connectionServer\cs.cfg Per configurare il file cs.cfg, impostare i parametri sotto il tag JavaVM, come segue: <ClassPath> <Path>\\data-federator-drivers-install-dir\\OaJdbcBridge\\oajava\\oasql.jar</Path> <Path>\\data-federator-drivers-install-dir\\JdbcDriver\\thindriver.jar</Path> </ClassPath> 8.4 Configurazione delle connessioni Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator Quando si creano connessioni Web Intelligence Rich Client che utilizzano il middleware ODBC Data Federator, è necessario apportare le modifiche alla configurazione descritte in questa sezione. Senza le necessarie correzioni alla configurazione, la connessione genera errori. Questo tipo di connessione è supportata solo in un ambiente Windows. Promemoria: Le informazioni che seguono fanno riferimento solo a Web Intelligence Rich Client. Per creare connessioni che utilizzano il middleware ODBC Data Federator, è necessario modificare le configurazioni di: • Middleware ODBC • Connection Server • Chiave di registro Windows RichClient I dettagli di configurazione riportati in questa sezione fanno riferimento ai seguenti percorsi: • dir-installaz-driver-data-federator\OaJdbcBridge: la directory di installazione principale del middleware ODBC Data Federator. L'amministratore sceglie questa directory al momento dell'esecuzione del programma di installazione dei driver di Data Federator. • dir-installaz-driver-data-federator\JdbcDriver: la directory di installazione principale del middleware JDBC Data Federator. L'amministratore sceglie questa directory al momento dell'esecuzione del programma di installazione di Data Federator. • dir-installaz-bo: la directory di installazione principale delle applicazioni SAP BusinessObjects. Nota: Modificare i file utilizzando un editor XML per essere certi che i file siano corretti. 136 2013-07-02 Creazione di una connessione al server delle query di Data Federator XI 3.0 Argomenti correlati • Configurazione del middleware ODBC Data Federator per una connessione a Web Intelligence Rich Client • Configurazione di Connection Server per una connessione Web Intelligence Rich Client a Data Federator • Impostazione della chiave di registro di Windows RichClient • Configurazione di Connection Server per le connessioni a Data Federator di Web Intelligence Rich Client o di Universe Design Tool 8.4.1 Configurazione del middleware ODBC Data Federator per una connessione a Web Intelligence Rich Client Per configurare il middleware ODBC Data Federator, è necessario modificare il file openrda.ini. Questo file è installato nella seguente directory: • dir-installaz-driver-data-federator\OaJdbcBridge\bin\iwinnt Per configurare il file openrda.ini, impostare i parametri nella sezione [JavaIp], come segue: • CLASSPATH=dir-installaz-driver-data-federator\OaJdbcBridge\oajava\oas ql.jar;dir-installaz-driver-data-federator\JdbcDriver\thindriver.jar;dirinstallaz-bo\SAP BusinessObjects Enterprise XI 4.0\java\lib\ConnectionSer ver.jar • JVM_DLL_NAME=dir-installaz-bo\javasdk\jre6\bin\client\jvm.dll Nota: Web Intelligence Rich Client richiede JDK 6. • JVM_OPTIONS=-DODBCMode=true -Dbusinessobjects.connectivity.directory=dirinstallaz-bo\SAP BusinessObjects Enterprise XI 4.0\dataAccess\connection Server Nota: Controllare il file openrda.ini per assicurare che questo percorso non sia impostato utilizzando il parametro Djava.endorsed.dirs. Se lo è, è necessario rimuovere il percorso dal parametro Djava.endorsed.dirs. 8.4.2 Configurazione di Connection Server per una connessione Web Intelligence Rich Client a Data Federator 137 2013-07-02 Creazione di una connessione al server delle query di Data Federator XI 3.0 Per configurare Connection Server per una connessione Web Intelligence Rich Client a Data Federator, è necessario modificare il file di configurazione: dir-installazione-connectionserver\conne ctionServer\cs.cfg Per configurare il file cs.cfg, impostare i parametri sotto il tag JavaVM, come segue: <ClassPath> <Path>\\data-federator-drivers-install-dir\\OaJdbcBridge\\oajava\\oasql.jar</Path> <Path>\\data-federator-drivers-install-dir\\JdbcDriver\\thindriver.jar</Path> </ClassPath> 8.4.3 Impostazione della chiave di registro di Windows RichClient Per modificare la chiave di registro di Windows RichClient, utilizzare uno strumento quale regedit. 1. Nel registro di sistema, individuare la chiave HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Suite XI 4.0\default\WebIntelligence\RichClient. 2. In questa chiave, aggiungere i seguenti valori alla voce classpath. Come per tutti i valori delle chiavi di registro, i valori devono essere separati dal carattere punto e virgole (;). • dir-installaz-driver-data-federator\OaJdbcBridge\oajava\oasql.jar • dir-installaz-driver-data-federator\JdbcDriver\thindriver.jar 3. Nella chiave RichClient\JVMOptions, aggiungere il seguente valore alla voce 6 (se esistono già cinque voci): • ODBCMode=true 8.4.4 Configurazione di Connection Server per le connessioni a Data Federator di Web Intelligence Rich Client o di Universe Design Tool È possibile utilizzare un'unica configurazione per creare una connessione ODBC a Data Federator da Universe Design Tool nonché da Web Intelligence Rich Client. Oltre alle impostazioni di configurazione descritte in precedenza, attenersi a una delle procedure riportate di seguito: • Effettuare quanto segue 1. Eseguire lo strumento regedit. 2. Nel registro di sistema, individuare la chiave HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Suite XI 4.0\default\ConnectionServer\Configuration. 3. In questa chiave, aggiungere il valore seguente al valore di JVM Library: dir-installazbo\javasdk\jre6\bin\client\jvm.dll. 138 2013-07-02 Creazione di una connessione al server delle query di Data Federator XI 3.0 • Effettuare quanto segue 1. Aprire il file cs.cfg per la modifica. 2. Individuare il tag JavaVM. 3. Impostare LibraryName sullo stesso percorso di directory JVM specificato nel openrda.ini: ... <JavaVM> <LibraryName JNIVersion="JNI_VERSION_1_4">\\bo-install-dir\\javasdk\\jre6\\bin\\client\\jvm.dll</Li braryName> </JavaVM> Avvertenza: per lo strumento di progettazione degli universi e il bridge OpenEdge deve essere specificato lo stesso percorso di directory JVM. 139 2013-07-02 Creazione di una connessione al server delle query di Data Federator XI 3.0 140 2013-07-02 Configurazione dei parametri globali di accesso ai dati Configurazione dei parametri globali di accesso ai dati 9.1 Informazioni sui parametri globali È possibile configurare valori di parametri globali, validi per tutte le connessioni. I parametri globali consentono di migliorare le prestazioni o risolvere problemi di connessione. I parametri globali di accesso ai dati vengono gestiti nel file cs.cfg. Si tratta di un file XML contenente i parametri di configurazione di Connection Server nonché i parametri di configurazione predefiniti applicabili a tutti i driver di accesso ai dati. Per ignorare le impostazioni globali, è possibile modificare le impostazioni nel file di configurazione SBO di ciascun driver. Argomenti correlati • Configurazione dei parametri del driver 9.2 Informazioni sul file di configurazione cs.cfg In Microsoft Windows, il file cs.cfg si trova nel seguente percorso: • dir-installaz-connectionserver \connectionServer Nel file cs.cfg è possibile configurare i parametri solo nelle seguenti sezioni: • Capabilities In questa sezione vengono definiti i parametri che consentono di specificare l'utilizzo di un Connection Server locale o remoto. • Impostazioni In questa sezione vengono definiti i parametri di configurazione globali di Connection Server, inclusi i driver da caricare all'avvio in modalità libreria. • JavaVM In questa sezione viene definita la libreria predefinita di Java Virtual Machine (JVM) utilizzata dal livello di accesso ai dati. 141 2013-07-02 Configurazione dei parametri globali di accesso ai dati • DriverDefaults In questa sezione vengono definiti i parametri da applicare per tutti i driver di accesso ai dati. Tali parametri possono essere sostituiti per un driver specifico dalle impostazioni corrispondenti contenute nei file di configurazione <driver>.sbo, dove <driver> è il nome del driver di accesso ai dati a cui fa riferimento il file SBO. • Analisi In questa sezione vengono definiti i parametri che consentono di registrare l'attività di connessione nei file di registro tramite Connection Server. Infine, nella sezione Locales viene definito il set di caratteri del sistema operativo per ogni lingua disponibile. I parametri di questa sezione non devono essere modificati. 9.3 Informazioni sul file di configurazione OlapClient.cfg In Microsoft Windows, il file OlapClient.cfg si trova nel seguente percorso: • bip-install-dir\win32_x86 Nel file OlapClient.cfg è possibile configurare solo parametri della sezione OlapClient. Argomenti correlati • Attivazione di registri e analisi per il client OLAP 9.4 Visualizzazione e modifica del file cs.cfg 1. Individuare la directory contenente il file cs.cfg. Ad esempio, in un sistema Microsoft Windows: dir-installaz-connectionserver\connectionServer\cs.cfg dove dir-installazconnectionserver è il percorso in cui è installato il software Connection Server. 2. Aprire il file cs.cfg in un editor XML. 3. Espandere le sezioni come necessario. 4. Impostare i parametri aggiungendo nuovi parametri o valori o modificando i valori dei parametri esistenti. 5. Verificare che il documento sia valido rispetto al DTD, quindi salvare e chiudere il file. Promemoria: è necessario riavviare Connection Server dopo aver modificato il file cs.cfg. 142 2013-07-02 Configurazione dei parametri globali di accesso ai dati 9.5 Configurazione dei parametri delle impostazioni globali La sezione Settings del file cs.cfg definisce le impostazioni valide per tutti i driver e che non possono essere personalizzate per singoli driver di accesso ai dati. Per visualizzare o modificare i parametri, aprire il file cs.cfg in un editor XML e accedere alla sezione Settings. Nel file, ogni parametro è definito nel seguente tag: <Parameter Name="parametro">valore</Parameter> dove parametro indica il nome del parametro e valore indica il valore attribuito al parametro. Ogni parametro viene visualizzato con le seguenti informazioni: • Esempio di visualizzazione del parametro nel file XML • Descrizione del parametro • Valori che è possibile impostare per il parametro (se applicabile) • Valore predefinito per il parametro Nota: alcune impostazioni possono essere modificate solo nella Central Management Console (CMC). Per ulteriori informazioni a riguardo, fare riferimento al Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. 9.5.1 Charset List Extension <Parameter Name="CharSet List Extension">crs</Parameter> Descrizione Nota: Non modificare questa impostazione. Definisce l’estensione dei file di set di caratteri. Predefinita 143 crs 2013-07-02 Configurazione dei parametri globali di accesso ai dati 9.5.2 Config File Extension <Parameter Name="Config File Extension">sbo</Parameter> Descrizione Nota: Non modificare questa impostazione. Definisce l’estensione del file per i file di configurazione generali. Predefinita sbo 9.5.3 Description Extension <Parameter Name="Description Extension">cod</Parameter> Descrizione Nota: Non modificare questa impostazione. Definisce l’estensione dei file di descrizione delle connessioni. Predefinita cod 9.5.4 Ignore Driver Load Failure <Parameter Name="Ignore Driver Load Failure">Yes</Parameter> 144 2013-07-02 Configurazione dei parametri globali di accesso ai dati Descrizione Determina l'azione da intraprendere quando il caricamento di un driver non riesce. Il parametro consente di scegliere se utilizzare comunque una connessione senza tutti i driver in esecuzione oppure che venga generato un errore irreversibile senza alcuna funzionalità quando il caricamento di un driver non riesce. Nota: Questo parametro viene ignorato in modalità distribuzione server. Yes: Connection Server genera un messaggio di avviso quando il caricamento di un driver non riesce. Valori No: Connection Server genera un errore irreversibile quando il caricamento di un driver non riesce. Predefinita Yes Argomenti correlati • Load Drivers On Startup 9.5.5 Load Drivers On Startup <Parameter Name="Load Drivers on Startup">No</Parameter> Avvertenza: Load Drivers On Startup è valido solo in modalità libreria. Descrizione Determina il modo in cui vengono caricate le librerie. • Yes: tutti i driver installati vengono caricati durante la fase di inizializzazione. • No: i driver vengono caricati su richiesta. Valori Predefinita 145 No 2013-07-02 Configurazione dei parametri globali di accesso ai dati 9.5.6 Max Pool Time <Parameter Name="Max Pool Time">-1</Parameter> Avvertenza: Durata massima del pool è disponibile solo in modalità libreria. È possibile modificare il timeout del connection pool per la modalità server nella pagina "Proprietà" del server nella CMC. Consultare il Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. Il valore è applicabile alle installazioni server autonome di Connection Server. Per informazioni sulla distribuzione di Connection Server su un nodo dedicato, consultare il Manuale della pianificazione della distribuzione della piattaforma SAP BusinessObjects Business Intelligence. Descrizione Stabilisce il periodo massimo che una connessione non utilizzata può rimanere inattiva nel connection pool. Rappresenta il limite superiore per la durata delle connessioni. Un connection pool è un meccanismo utilizzato dai driver di accesso ai dati per riutilizzare le connessioni al database al fine di sfruttare al meglio le risorse del sistema. È possibile impostare Durata massima del pool solo per la modalità di distribuzione libreria. Il valore viene applicato ai nodi su cui è installato Connection Server con prodotti server. -1: nessun timeout, connessione attiva durante l'intera sessione. Valori 0: connessione non gestita dal pool. >0: durata di inattività (in minuti). Impostazione predefinita -1 Argomenti correlati • Pool di connessioni 9.5.7 Setup File Extension <Parameter Name="Setup File Extension">setup</Parameter> 146 2013-07-02 Configurazione dei parametri globali di accesso ai dati Descrizione Nota: Non modificare questa impostazione. Imposta l'estensione per i file dei driver di accesso ai dati. Impostazione predefinita setup 9.5.8 SQL External Extension <Parameter Name="SQL External Extension">rss</Parameter> Descrizione Nota: Non modificare questa impostazione. Definisce l’estensione del file per i file SQL esterni. Predefinita rss 9.5.9 SQL Parameter Extension <Parameter Name="SQL Parameter Extension">prm</Parameter> Descrizione Nota: Non modificare questa impostazione. Definisce l’estensione del file per i file dei parametri SQL. Predefinita 147 prm 2013-07-02 Configurazione dei parametri globali di accesso ai dati 9.5.10 Strategies Extension <Parameter Name="Strategies Extension">stg</Parameter> Descrizione Nota: Non modificare questa impostazione. Definisce l’estensione del file per i file di strategia. Predefinita stg 9.5.11 Validate Configuration Files <Parameter Name="Validate Configuration Files">No</Parameter> Causa la convalida dei file di configurazione (SBO, COD e PRM) rispetto allo schema XML. Descrizione Nota: È possibile convalidare i file di configurazione solo quando si utilizza la connettività basata su Java. Predefinita No 9.5.12 Validate XML Streams <Parameter Name="Validate XML Streams">No</Parameter> 148 2013-07-02 Configurazione dei parametri globali di accesso ai dati Causa la convalida dei flussi XML analizzati nell'implementazione di Connection Server rispetto allo schema XML (ad esempio: definizione della connessione). Descrizione Predefinita Nota: È possibile convalidare i flussi XML solo quando si utilizza la connettività basata su Java. No 9.6 Impostazione della modalità di distribuzione La sezione Capabilities consente di specificare la modalità di distribuzione di Connection Server da utilizzare in fase di esecuzione. Sotto la sezione Capabilities, il nome Local indica che il servizio di connettività è fornito localmente, come libreria in-proc incorporata nel processo client. Remote indica invece che Connection Server è fornito su un server remoto. È possibile abilitare queste modalità di distribuzione in maniera indipendente, impostando l'attributo Active. Per quanto riguarda Local, l'attributo EnableJNI abilita l'utilizzo di Java Native Interface (JNI). Nota: Un'interfaccia JNI a due direzioni in Connection Server consente alle API di funzionare con il sistema di Connection Server sviluppato in un linguaggio diverso. Ciò significa che è possibile utilizzare l'API Java con il sistema nativo e viceversa. Esempio: Valori predefiniti La seguente configurazione consente la modalità di distribuzione librerie con JNI e la modalità di distribuzione server. <Capabilities> <Capability Name="Local" EnableJNI="Yes" Active="Yes"/> <Capability Name="Remote" Active="Yes"/> </Capabilities> Esempio: Connection Server in modalità server La seguente configurazione consente di utilizzare Connection Server solo in modalità server. <Capabilities> <Capability Name="Local" EnableJNI="Yes" Active="No"/> 149 2013-07-02 Configurazione dei parametri globali di accesso ai dati <Capability Name="Remote" Active="Yes"/> </Capabilities> In questa modalità, per creare connessioni è possibile utilizzare solo i driver installati sul sistema back-end della piattaforma BI. Se è in esecuzione un'istanza server, è possibile creare una connessione basata su un driver installato sul sistema back-end della piattaforma. Se si interrompe l'istanza server, non è possibile creare alcuna connessione, poiché questa impostazione non consente di utilizzare un driver installato sul computer client. Argomenti correlati • Servizi di connessione 9.7 Configurazione della modalità di distribuzione I parametri definiti nella sezione Settings del file cs.cfg controllano la modalità di distribuzione. Modalità libreria I parametri della sezione Library controllano la modalità Libreria. Modalità server Questa modalità può essere gestita dalla CMC dell'installazione di SAP BusinessObjects Enterprise. I parametri visualizzati nella pagina "Proprietà" del server controllano l'accesso a CORBA. Per ulteriori informazioni, consultare il Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. 9.8 Configurazione dei driver da caricare Per impostazione predefinita, Connection Server carica tutti i driver disponibili. È tuttavia possibile selezionare le origini dati che devono essere esposte da Connection Server. Modalità libreria Rimuovere i commenti nella sezione ActiveDataSources al di sotto di Library nel file cs.cfg e specificare i livelli di rete e i database da caricare. Ad esempio: <Library> <ActiveDataSources> <NetworkLayer Name="ODBC"> <DataBase Name="MS SQL Server.*$"/> </NetworkLayer> <NetworkLayer Name="Oracle OCI"> <DataBase Name="Oracle 10"/> 150 2013-07-02 Configurazione dei parametri globali di accesso ai dati </NetworkLayer> </ActiveDataSources> </Library> Nota: per i nomi dei database è possibile utilizzare espressioni regolari se queste sono composte unicamente da caratteri ASCII e utilizzano la sintassi GNU regexp. Utilizzare il criterio .* per trovare una corrispondenza per qualsiasi carattere. Per ulteriori informazioni sulle espressioni regolari, consultare il sito Web PERL all'indirizzo http://www.perl.com/doc/manual/html/pod/perlre.html#Regular_Expressions. Modalità server Selezionare le origini dati nella sezione Attiva origini dati delle proprietà del server in CMC. Avvertenza: Per evitare errori di connessione, assicurarsi che l'ambiente fornisca tutto il middleware necessario. In caso contrario, è necessario impostare solo i livelli di rete e i database necessari nella sezione Attiva origini dati. Consentendo la specializzazione dei server, questa impostazione si rivela utile anche in scenari di distribuzione complessi in cui vengono utilizzati più Connection Server in modalità server. Per ulteriori informazioni sugli scenari di distribuzione complessi, fare riferimento al Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. 9.8.1 Impostazione di una connettività per computer Negli scenari di distribuzione complessi, è preferibile impostare una connettività per tipo di computer, ad esempio connettere le applicazioni in dotazione con la piattaforma BI a un database SQL Server installato su Microsoft Windows e a un database Oracle installato su un computer UNIX. Per evitare errori di connessione, è necessario effettuare una delle operazioni seguenti: • Quando si esegue un'installazione personalizzata della piattaforma BI, specificare le connessioni da distribuire per ogni tipo di database necessario. Questa operazione viene eseguita quando si selezionano le funzionalità da installare. • Quando si configura Connection Server nel file cs.cfg, impostare la sezione ActiveDataSources per la modalità libreria (elemento principale di Library) analogamente alla modalità server nella CMC. Poiché le applicazioni tentano subito di stabilire le connessioni tramite i driver installati in locale, è opportuno configurare il filtro driver allo stesso modo per entrambe le modalità. 9.9 Configurazione dei protocolli di accesso CORBA I protocolli di accesso CORBA vengono impostati nella CMC della piattaforma BI. I protocolli definiscono i valori utilizzati da Connection Server per elaborare le richieste provenienti da client CORBA o HTTP. 151 2013-07-02 Configurazione dei parametri globali di accesso ai dati Per ulteriori informazioni sulla CMC, consultare il Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. 9.10 Attivazione di registri e analisi di Connection Server e dei relativi driver SAP distingue tra due tipi di messaggi: • • Un messaggio di analisi analizza il sistema in dettaglio dal punto di vista di uno sviluppatore, come procedura eccezionale. Un messaggio registro è un record permanente degli eventi e dello stato di un sistema. I messaggi registro sono destinati agli amministratori di sistema, mentre le analisi sono destinate agli sviluppatori. È possibile abilitare registri e tracce per tutte le connettività supportate dal livello di accesso ai dati (ad esempio, ODBC, JDBC, Javabean, OLE DB, OCI e JCo). Il processo di registrazione e analisi di Connection Server si basa sulla funzionalità di registrazione e analisi del servizio log analisi di SAP BusinessObjects e consente di registrare e analizzare i seguenti processi: File di registro • • • Avvio e interruzione di istanze server di Connection Server Inizializzazione del Single Sign On Caricamento dei driver Analisi • • • • • • Inizializzazione e configurazione di Connection Server Creazione ed esecuzione di processi e dizionari Caricamento e attività dei driver Avvio e interruzione di istanze server di Connection Server Inizializzazione e attività di servizi delle istanze server di Connection Server Inizializzazione del Single Sign On 9.10.1 Informazioni sul file di configurazione _trace.ini I livelli di registrazione e analisi si impostano nel file di configurazione _trace.ini. È, ad esempio, possibile impostare le seguenti informazioni nel file BO_trace.ini: sap_log_level = log_info; sap_trace_level = trace_debug; if (process == "cms") { log_level = error; // but only log errors for the CMS } 152 2013-07-02 Configurazione dei parametri globali di accesso ai dati Contenuto del file Nell'esempio precedente, i tag definiti sono i seguenti: • • • sap_log_level, che definisce il livello di registrazione sap_trace_level, che definisce il livello di analisi Porzione di codice che consente di specificare il livello di registrazione e analisi per un processo. Il codice si basa su C o Java e può contenere espressioni, istruzioni semplici e istruzioni if-else. Nelle seguenti tabelle vengono descritti i valori di configurazione accettati dai tag sap_log_level e sap_trace_level. Tabella 9 - 14: Livello di registrazione SAP Gravità Valori di configurazione INFO log_info o log_information AVVISO log_warn o log_warning ERROR log_error FATAL log_fatal NONE log_none Tutti i messaggi del livello di gravità impostato e di livello superiore vengono visualizzati nel file di registro. Se, ad esempio, si imposta la gravità di registrazione su WARNING, verranno registrati tutti i messaggi di gravità WARNING, ERROR e FATAL. La gravità di registrazione predefinita è ERROR. Tabella 9 - 15: Livello traccia SAP 153 Gravità Valori di configurazione DEBUG trace_debug PATH trace_path INFO trace_info o trace_information ERROR trace_error 2013-07-02 Configurazione dei parametri globali di accesso ai dati Gravità Valori di configurazione NONE trace_none Tutti i messaggi del livello di gravità impostato e di livello superiore vengono visualizzati nel file di registro. Se si imposta, ad esempio, la gravità di analisi su INFO, verranno registrati tutti i messaggi di gravità INFO ed ERROR. La gravità di analisi predefinita è ERROR. Opzioni di configurazione È inoltre possibile aggiungere le seguenti opzioni al file: 154 Opzione Valori Descrizione always_close true o false Chiude il file di registro dopo ogni scrittura. Il valore predefinito è false. append true o false Aggiunge informazioni di registrazione ai file di registro esistenti. Modifica i criteri di denominazione per escludere PID e timestamp e utilizza invece un numero di file di registro in corso. Il valore predefinito è false. keep_num un numero intero Specifica il numero di file di registro da mantenere. Il valore predefinito è 0. Un numero intero negativo indica che verranno mantenuti tutti i file di registro. log_dir una stringa Specifica la directory dei file di registro. Il valore predefinito corrisponde al valore della variabile d'ambiente BO_TRACE_LOGDIR. Un trattino (-) indica che le informazioni di registrazione vengono indirizzate a stdout. log_level none, low, me dium o high Definisce un collegamento per specificare entrambi i valori sap_log_level e sap_trace_level. Vedere la tabella seguente. 2013-07-02 Configurazione dei parametri globali di accesso ai dati Opzione Valori Descrizione Specifica se nei file di registro vengono visualizzati solo i messaggi associati ad ambiti. Il valore predefinito è false. scope_only true o false Nota: Un ambito contrassegna l'ingresso e l'uscita da un blocco di codice. size un numero espresso in KB Dimensione massima di un file di registro. Il valore predefinito è 10000. Valori dell'opzione log_level Nella seguente tabella sono riportati i valori sap_log_level e sap_trace_level impostati quando viene specificato il valore log_level corrispondente nel file di configurazione. Valore log_level Valore sap_log_level Valore sap_trace_level none log_error trace_error low log_error trace_info medium log_warn trace_path high log_info trace_debug Errori di analisi Gli errori e gli avvisi che possono essere generati quando si analizza il file _trace.ini vengono scritti in un file ERR nella stessa directory del file INI. Il nome del file di errore è costituito dal nome del file INI. Se lo stesso file INI viene condiviso da diversi processi, non è possibile sapere quale processo ha generato l'errore. Per generare nomi di file di errore più informativi, aggiungere le seguenti righe nella parte superiore del file _trace.ini: error_file = config_file + "_" + process + ".err"; output_file = config_file + "_" + process + ".out"; 155 2013-07-02 Configurazione dei parametri globali di accesso ai dati 9.10.2 Attivazione di registri e analisi nel file cs.cfg È possibile trovare registri e analisi di Connection Server con quelli delle applicazioni SAP BusinessObjects, come SAP BusinessObjects Web Intelligence. È inoltre possibile registrare e analizzare Connection Server separatamente configurando il file cs.cfg. La sezione Traces del file consente di attivare analisi per i processi e i driver Connection Server. È possibile attivare l'analisi dei processi impostando l'attributo Active di Job e JobLevel su Yes. È possibile attivare l'analisi dei driver impostando l'attributo Active di Middleware su Yes. È possibile attivare l'analisi per un driver specifico impostando l'attributo Active del driver su Yes. Esempio: Valori predefiniti <Traces Active="Yes"> <Logger Implementation="C" ClassID="csTRACELOG"> <Logger Implementation="Java" ClassID="com.sap.connectivity.cs.logging.TraceLogLogger"/> <Trace Name="JobLevel" Active="Yes"> <Trace Name="Job" Active="Yes"/> </Trace> <Trace Name="MiddleWare" Active="Yes"> <Trace Name="Oracle" Active="Yes"/> <Trace Name="Sybase" Active="Yes"/> <Trace Name="DB2" Active="Yes"/> ... <Trace Name="JCO" Active="Yes"/> <Trace Name="BO OC" Active="Yes"/> </Trace> </Traces> Questa configurazione consente, per impostazione predefinita, la registrazione e l'analisi di Connection Server e dei driver. 9.10.3 Attivazione di registri e analisi in modalità libreria 1. Arrestare Connection Server. 2. Creare e impostare valori per le seguenti variabili di ambiente: • BO_TRACE_CONFIGDIR, per impostare il nome dei file di configurazione per i registri, ad esempio: C:\BOTraces\config • BO_TRACE_CONFIGFILE, per impostare il nome del file di configurazione, ad esempio BO_Trace.ini • BO_TRACE_LOGDIR, per impostare il nome della cartella per i registri, ad esempio: C:\BOTraces Nota: queste variabili di ambiente vengono generalmente utilizzate per configurare l'analisi di tutta l'attività della piattaforma BI. 156 2013-07-02 Configurazione dei parametri globali di accesso ai dati 3. Creare il file di configurazione BO_Trace.ini come segue: sap_log_level = log_info; sap_trace_level = trace_debug; Nota: il nome del file INI supporta la distinzione tra maiuscole e minuscole. 4. Aggiungere i percorsi di directory dei file logging.jar e tracelog.jar alla variabile di ambiente CLASSPATH. Ad esempio: C:\BOTraces\lib\logging.jar e C:\BOTraces\lib\tracelog.jar. 5. Riavviare il Connection Server. I registri e le analisi vengono scritti in un file il cui nome predefinito è TraceLog_<pid>_<timesta mp>_trace.log. Se si desidera impostare un altro nome per il file di registro, aggiornare la variabile di ambiente BO_TRACE_PROCESS con il nuovo nome. 9.10.4 Attivazione di registri e analisi in modalità server È possibile abilitare l'analisi per i processi e i driver della CMC. In questo modo si consente al server di restare in esecuzione mentre si abilita l'analisi. 1. Avviare la CMC. 2. Andare alla pagina Proprietà del server ConnectionServer (per il Servizio di connessione nativo) o di Adaptive Processing Server (per il Servizio di connessione adattivo). 3. Nella sezione "Analisi livello basso" selezionare: • Abilita analisi processo per abilitare l'analisi dei processi • Abilita analisi middleware per abilitare l'analisi del middleware Nota: Il livello Log analisi deve essere impostato su Alto nella sezione "Servizio log analisi". Questo livello è diverso dal livello di registrazione SAP definito tramite il file BO_Trace.ini. Promemoria: l'impostazione Abilita analisi middleware consente di analizzare tutto il middleware. Se si desidera analizzare solo middleware specifico, è necessario configurare il file cs.cfg e riavviare il server. 9.10.5 Lettura di registri e analisi Le analisi e i registri di Connection Server sono contrassegnati da |CS| nei file di traccia. I registri di Connection Server sono identificati anche dall'espressione THIS IS A LOG. Ogni funzione dispone di un'analisi specifica. Le analisi contengono le seguenti informazioni: 157 2013-07-02 Configurazione dei parametri globali di accesso ai dati • • • • • • Analisi ENTER, che identificano la chiamata all'API middleware. Le analisi EXIT identificano la chiamata restituita. L'API middleware non restituisce alcuna chiamata se non è presente alcun elemento EXIT dopo ENTER. Eccezioni della chiamata, se viene visualizzato |E| Errori API, se viene visualizzato il codice restituito -1 Errore o gravità registro (ad esempio, Debug, Path o Information) Livello di rete e database analizzati nella sezione [Network Layer|Database|ID] dell'analisi Messaggi di registro e di errore Esempio: Analisi Di seguito è riportato un estratto di analisi con gravità DEBUG e PATH, ottenuto quando Connection Server è stato utilizzato in modalità libreria: |BE42CC9D40484416BADEF01039652F620|2012 04 12 11:41:27.422|+0200|Debug| |<<| | |TraceLog| 5256| | ||||||||||||||||||||CS||[unknown|unknown|ID:0]CS Internal Configuration: |BE42CC9D40484416BADEF01039652F621|2012 04 12 11:41:27.534|+0200|Debug| |<<| | |TraceLog| 5256| | ||||||||||||||||||||CS||[unknown|unknown|ID:0] 1|main 1|main ... |BE42CC9D40484416BADEF01039652F628|2012 04 12 11:41:27.920|+0200|Path| | | | |TraceLog| 5256| 1|main | ||||||||||||||||||||CS||ENTER [JDBC|Oracle 11|ID:0]com.sap.connectivity.cs.java.ConnectionMana ger{com.businessobjects.connectionserver.ConnectionManager}.close |BE42CC9D40484416BADEF01039652F629|2012 04 12 11:41:27.920|+0200|Path| | | | |TraceLog| 5256| 1|main | ||||||||||||||||||||CS||EXIT [JDBC|Oracle 11|ID:0]com.sap.connectivity.cs.java.ConnectionMana ger{com.businessobjects.connectionserver.ConnectionManager}.close Esempio: Analisi Di seguito è riportato un estratto di analisi con gravità INFO, ottenuto quando Connection Server è stato utilizzato in modalità server: |6E606102224D49849A2C17D8691FAC785011|2012 04 26 19:02:43.075|+0200|Information| |==| | |aps_MySIA.csjava| 7088| 53|service builder-4| ||||||||||||||||||||CS||[unknown|unknown|ID:0]Starting CORBA NetworkLayer service... Esempio: Registro Di seguito è riportato un estratto di registro ottenuto quando Connection Server è stato utilizzato in modalità server: |6E606102224D49849A2C17D8691FAC7B5114|2012 04 26 19:02:43.805|+0200| |Information| | | |aps_MySIA.csjava| 7088| 61|service builder-1| ||||||||||||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Loaded driver: NetworkLayer=JDBC, Database=Generic JDBC datasource |6E606102224D49849A2C17D8691FAC7B5116|2012 04 26 19:02:43.817|+0200| |Information| | | |aps_MySIA.csjava| 7088| 61|service builder-1| ||||||||||||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Loaded driver: NetworkLayer=JDBC, Database=MaxDB 7.7 ... |43eabdad-d3e4-ec14-89aa-0c9a9fba3101|2012 04 26 19:02:20:883|+0200| |Information| | | |connectionserver_My SIA.ConnectionServer|1576|7816|| |0|94|0|2|-|-|-|-|-|-||||||||||CS||THIS IS A LOG [unknown|unknown|ID:0]Co nnectionServer is now started 158 2013-07-02 Configurazione dei parametri globali di accesso ai dati 9.11 Attivazione di registri e analisi per il client OLAP È possibile trovare registri e analisi del client OLAP con quelli delle applicazioni SAP BusinessObjects, come SAP BusinessObjects Web Intelligence. È, ad esempio, possibile trovarli con analisi del server di elaborazione Web Intelligence. È inoltre possibile registrare e analizzare il client OLAP separatamente configurando il file OlapClient.cfg. I registri vengono attivati impostando l'attributo UseLog su yes nella sezione OlapClient del file. Il percorso del file di registro viene specificato nell'attributo LogFileName. Non si deve modificare il valore UseProcessName. Non è necessario interrompere il server di elaborazione Web Intelligence per modificare queste impostazioni. È possibile attivare i registri e le analisi mentre il server è in esecuzione. Esempio: [OlapClient] UseLog =yes UseProcessName=false LogFileName =c:\OlapClient.log ; Factory Mode can be: Lib (inproc) or Proxy (Remoting) FactoryMode=Lib ... Questa configurazione consente la registrazione e l'analisi per il client OLAP. Argomenti correlati • Informazioni sul file di configurazione OlapClient.cfg 9.11.1 Esempio di registro Il seguente esempio è un estratto di un file di registro per il cliente OLAP ottenuto per una connessione MSAS. ... [2012/11/05 - 12:04:54:025][0] version 6.1.7600.16385 [2012/11/05 - 12:04:54:025][0] [2012/11/05 - 12:04:54:040][0] [2012/11/05 - 12:04:54:040][0] Proxy= ProxyBypass= [2012/11/05 - 12:04:54:040][0] wxp' Port=80 [2012/11/05 - 12:04:54:040][0] [2012/11/05 - 12:04:54:040][0] [2012/11/05 - 12:04:54:040][0] [2012/11/05 - 12:04:54:040][0] [2012/11/05 - 12:04:54:040][0] [2012/11/05 - 12:04:54:040][0] tion, defaulting to 100(s). 159 XmlaConnectionWinhttp::XmlaConnectionWinhttp() -> Using Windows HTTP Services HTTPClient::connect() -> Using direct access HTTPClient::connect() -> Using Windows Proxy Automatic Discovery (WPAD) HTTPClient::connect() -> Using proxy settings: WPAD url=http://proxy:8083, HTTPClient::connect() -> Connecting using WinHttpConnect(): Hostname='olapXmlaConnectionWinhttp::Open() -> Connected. XmlaClient::discover() Call 'DISCOVER_DATASOURCES'... SoapEnvelope::updateProperties() BeginRange=-1 EndRange=-1 XmlaConnectionWinhttp::SendRequest() Authentication Mode = Credentials. XmlaConnectionWinhttp::SendRequest() Setting basic credential to HttpRequest. XmlaConnection::getTimeout() No timeout was specified in ConnectionSpecifica 2013-07-02 Configurazione dei parametri globali di accesso ai dati [2012/11/05 - 12:04:54:056][0] XmlTextReader::XmlTextReader() Using libXML version 2.06.32 [2012/11/05 - 12:04:54:056][0] XmlaClient::discover() Rowset contains 1 rows [2012/11/05 - 12:04:54:056][0] XmlaClient::discover() Call 'DISCOVER_DATASOURCES' ElapseTime=15ms [2012/11/05 - 12:04:54:056][0] XmlaClient::createOlapEntities() -> Rowset=[DISCOVER_DATASOURCES], 1 entities retrieved Elapse=15ms [2012/11/05 - 12:04:54:056][0] XmlaClient::discover() Call 'DISCOVER_SCHEMA_ROWSETS'... [2012/11/05 - 12:04:54:072][0] SoapEnvelope::updateProperties() BeginRange=-1 EndRange=-1 [2012/11/05 - 12:04:54:072][0] XmlaConnectionWinhttp::SendRequest() Authentication Mode = Credentials. [2012/11/05 - 12:04:54:072][0] XmlaConnectionWinhttp::SendRequest() Setting basic credential to HttpRequest. [2012/11/05 - 12:04:54:072][0] XmlaConnection::getTimeout() No timeout was specified in ConnectionSpecifica tion, defaulting to 100(s). [2012/11/05 - 12:04:54:072][0] XmlTextReader::XmlTextReader() Using libXML version 2.06.32 [2012/11/05 - 12:04:54:072][0] XmlaClient::discover() Rowset contains 54 rows ... 160 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati Configurazione dei parametri dei driver di accesso ai dati 10.1 Configurazione dei parametri del driver Per configurare l'accesso ai dati per un determinato driver di accesso ai dati, è possibile modificare i file di configurazione del driver per adeguare le impostazioni dei parametri oppure creare direttamente le voci del database, nel caso in cui sia necessario creare connessioni per database specifici del proprio ambiente. Nota: Per ogni applicazione SAP BusinessObjects che utilizza Connection Server, il file Leggimi associato contiene informazioni sulle utilità della riga di comando che possono essere utilizzate per controllare la configurazione del motore RDBMS e del driver di accesso ai dati. Tali utilità sono in grado di creare file di registro che tengono traccia delle attività del server di Interactive Analysis. Consultare il file Leggimi della versione per istruzioni sull'utilizzo di queste utilità. Argomenti correlati • Informazioni sui parametri globali 10.1.1 File di configurazione per l'accesso ai dati I file di configurazione seguenti controllano le configurazioni dei driver di accesso ai dati per ciascuna connessione definita: • cs.cfg Questo file definisce i parametri globali da applicare a tutte le connessioni. Si trova nella directory dir-installazione-connectionserver\connectionServer. • <driver>.sbo Questo file è specifico per ogni driver di accesso ai dati. Il segnaposto <driver> rappresenta l'origine dati a cui viene applicato il file di configurazione. Ogni file SBO è in una sottodirectory della directory connectionServer, in cui il nome della sottodirectory fa riferimento al livello di rete o al middleware del database, ad esempio 161 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati dir-installazione-connectionserver\connectionServer\oracle per i database Oracle. Nota: I parametri impostati nella sezione DriverDefaults del file cs.cfg vengono sostituiti dalle impostazioni corrispondenti presenti nei file SBO. • <driver>.setup Questo file definisce il nome del file SBO, la directory e il livello di rete o il middleware del database a cui il driver è correlato. Questo file è necessario per poter utilizzare il driver. Non è possibile utilizzare un driver senza file di configurazione. Tutti i file si trovano nella directory dir-installazione-connectionserver\connectionServer\setup. Ad esempio, il seguente file oracle_jdbc.setup definisce il file di configurazione oracle.sbo per i driver di accesso ai dati utilizzati per stabilire le connessioni JDBC: ... <Driver> <NetworkLayer Name="JDBC"></NetworkLayer> <Directory>jdbc</Directory> <DataFileName>oracle</DataFileName> </Driver> ... Argomenti correlati • Informazioni sui parametri globali • File SBO installati 10.1.2 File SBO installati I seguenti file <driver>.sbo sono installati per impostazione predefinita in Microsoft Windows. Per un elenco aggiornato dei driver supportati, visitare il SAP Service Marketplace all'indirizzo ser vice.sap.com/bosap-support o contattare il rappresentante SAP di fiducia. 162 Sottodirectory Tecnologia di database File SBO db2 IBM DB2 db2.sbo essbase Oracle Essbase essbase.sbo javabean Javabean javabean.sbo 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati 163 Sottodirectory Tecnologia di database File SBO jco SAP ERP jco.sbo 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati Sottodirectory jdbc 164 Tecnologia di database File SBO Data Federator Server datafederator.sbo IBM DB2 db2.sbo Derby derby.sbo Greenplum e PostgreSQL greenplum.sbo HIVE hive.sbo HSQLDB hsqldb.sbo IBM Informix informix.sbo Ingres ingres.sbo JDBC generico jdbc.sbo MaxDB maxdb.sbo MySQL mysql.sbo HP Neoview neoview.sbo Netezza netezza.sbo SAP HANA newdb.sbo Oracle oracle.sbo Microsoft SQL Server sqlsrv.sbo Sybase sybase.sbo 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati Sottodirectory odata 165 Tecnologia di database File SBO Teradata teradata.sbo OData 2.0 odata.sbo 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati Sottodirectory odbc 166 Tecnologia di database File SBO Microsoft Access 2007 access.sbo Microsoft Access 2010 access2010.sbo Data Federator Server datafederator.sbo IBM DB2 iSeries db2iseries.sbo PostgreSQL 8 greenplum.sbo Greenplum 4 e PostgreSQL 9 greenplum4.sbo IBM Informix informix.sbo Ingres ingres.sbo MaxDB maxdb.sbo MS Excel 2007 msexcel.sbo MySQL mysql.sbo HP Neoview neoview.sbo Netezza netezza.sbo SAP HANA newdb.sbo ODBC generico e ODBC3 generico odbc.sbo OpenAccess per Salesforce openaccess.sbo File di testo e di Microsoft Excel 2010 personalfiles.sbo 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati Sottodirectory Tecnologia di database File SBO Microsoft SQL Server sqlsrv.sbo Sybase sybase.sbo Teradata teradata.sbo OLE DB generico oledb.sbo Microsoft SQL Server sqlsrv.sbo oledb_olap Microsoft Analysis Services slqsrv_as.sbo open File CSV open.sbo Oracle oracle.sbo Oracle EBS oracle_ebs.sbo sap SAP BW sap.sbo sybase Sybase sybase.sbo XML xml.sbo Servizi Web webservices.sbo oledb oracle xml La sottodirectory jdbc contiene i file di configurazione per la gestione delle connessioni ai database tramite il livello di rete JDBC. Per ulteriori informazioni sui database supportati per le connessioni JDBC, visitare il sito Web SAP Service Marketplace o controllare i file SBO. La sottodirectory odbccontiene il file di configurazione mysql.sbo per la gestione delle connessioni al database MySQL tramite il livello di rete ODBC. il database MySQL 5 è disponibile su tutte le piattaforme, con supporto Unicode. Accertarsi di utilizzare MySQL Connector/ODBC 5.1.4 o versione successiva per la connessione a questo database. Se si utilizza una versione precedente del driver in Unix, verranno generati errori in fase di esecuzione. 167 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati La sottodirectory odbc include i file di configurazione greenplum2010.sbo e access4.sbo per la gestione delle connessioni a Greenplum 4, PostgreSQL 9 e MS Access 2010 tramite il livello di rete ODBC. Questi file differiscono dai file greenplum.sbo e access.sbo poiché distribuiscono la configurazione tanto su MS Windows a 32 bit che a 64 bit. I database Greenplum 4 e PostgreSQL 9 sono disponibili anche in versione UNIX a 64 bit. La sottodirectory odbc include anche il file di configurazione msexcel.sbo per la gestione delle connessioni a MS Excel 2007 tramite il livello di rete ODBC. Questo file distribuisce la configurazione solo su MS Windows a 32 bit. Il file di configurazione personalfiles.sbo distribuisce la configurazione per MS Excel 2010 tramite ODBC su MS Windows sia a 32 bit che a 64 bit. La sottodirectory open contiene il file di configurazione open.sbo per la gestione delle connessioni ai file CSV tramite CSV OpenDriver. Se si sviluppa un driver CSV basato su un esempio di driver CSV Open con Java Driver Development Kit, è necessario posizionare tutti i file di configurazione in questa directory. Per ulteriori informazioni su questo driver, consultare il documento Data Access Driver Java SDK Developer Guide. 10.1.3 Visualizzazione e modifica dei file SBO Avvertenza: Prima di aprire un file SBO, eseguire una copia di backup del file. Alcuni parametri di configurazione non devono essere modificati. La modifica o l'eliminazione di tali parametri può compromettere il corretto funzionamento delle applicazioni SAP BusinessObjects. 1. 2. 3. 4. Individuare la directory contenente il file SBO del driver di accesso ai dati di destinazione. Aprire il file SBO in un editor XML. Espandere le sezioni come necessario. Individuare il tag appropriato per il valore da modificare, quindi modificare il valore. I parametri vengono visualizzati nel seguente formato: <Parameter Name="parametro">va lore</Parameter> doveparametro è il nome del parametro e valore è il valore assegnato al parametro. 5. Verificare che il file sia valido con DTD, salvarlo e chiuderlo. 10.1.4 Personalizzazione dei file SBO Avvertenza: Quando si installa un nuovo driver, può essere opportuno personalizzare i file SBO utilizzando voci e driver del proprio database. Per evitare possibili errori durante la modifica dei file SBO, SAP BusinessObjects consiglia di creare un file SBO separato in definire i database interessati dalla personalizzazione e le librerie utilizzate dal driver. È inoltre necessario creare prima un file di configurazione per la definizione del file SBO. Non è necessario modificare i registri. 168 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati 1. Creare un file di configurazione nella directory dir-installazione-connectionserver\co nnectionServer\setup utilizzando un editor XML. Specificare il nome del file SBO, la relativa directory e il livello di rete del database utilizzato per la connessione. 2. Verificare che il file sia valido con DTD, salvarlo e chiuderlo. 3. Selezionare la sottodirectory in cui verrà archiviato il file SBO o creare una sottodirectory come specificato nel file di configurazione. 4. Creare il file SBO con il database di destinazione e le librerie del driver utilizzando un editor XML. 5. Verificare che il file sia valido con DTD, salvarlo e chiuderlo. Nota: Oltre a personalizzare il file SBO, è necessario creare i file COD, PRM e RSS per ciascuno dei driver appena installati. 10.1.5 Verifica dinamica delle connessioni È possibile personalizzare il driver in modo tale che al runtime convalidi l'utilizzo di una connessione del connection pool. Il processo di convalida consiste nell'esecuzione di una query SQL senza effetti secondari quando la connessione viene recuperata dal pool. La connessione può essere utilizzata se la query SQL viene eseguita senza errori. In caso contrario, la connessione viene ignorata. Promemoria: Questa funzionalità è disponibile per le connessioni ODBC generica, OLE DB generica e JDBC generica. Tutte le altre connettività supportate gestiscono già questa verifica della connessione, quindi non è necessaria alcuna personalizzazione. 1. Arrestare Connection Server. 2. Aprire il file SBO del driver in uso. 3. Individuare la sezione DataBase relativa alla connessione in questione. Ad esempio, per una connessione ODBC generica: <DataBases> <DataBase Active="Yes" Name="Generic ODBC datasource"> <Libraries> ... </Libraries> <Parameter Name="CharSet Table" Platform="Unix">datadirect</Parameter> </DataBase> ... 4. Aggiungere la riga seguente alla sezione DataBase: <Parameter Name="Connection Check">SQL query</Parameter> dove SQL query è la query utilizzata per verificare la validità. 5. Salvare il file SBO. 6. Riavviare Connection Server. 169 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati Connection Server conferma che la connessione può essere utilizzata prima di eseguire la richiesta di dati. 10.1.6 Proprietà del driver JDBC È possibile aggiungere proprietà del driver JDBC effettuando una delle operazioni descritte di seguito: • • Nella procedura guidata di connessione dell'applicazione in uso, durante la creazione della connessione impostare il parametro "Proprietà driver JDBC (chiave=valore,chiave=valore):". È facoltativo. Impostare le proprietà del driver nel file SBO appropriato dopo aver interrotto il Connection Server. Se la proprietà viene impostata sia nel file SBO che attraverso la procedura guidata, solo il valore impostato mediante la procedura guidata viene preso in considerazione dall'applicazione. Esempio: Qui viene mostrata la sezione di un file oracle.sbo modificato con due proprietà del driver. <DataBase Active="Yes" Name="Oracle 10"> <Class JARFile="dbd_jdbc,dbd_oracle"> com.businessobjects.connectionserver.java.drivers.jdbc.oracle.OracleDriver</Class> <JDBCDriver> <Parameter Name="JDBC Class">oracle.jdbc.OracleDriver</Parameter> <Parameter Name="URL Format">jdbc:oracle:thin:@§DATASOURCE§:§DATABASE§</Parameter> <Properties> <Property Name="oracle.jdbc.defaultNChar">true</Property> <Property Name="defaultNChar">true</Property> </Properties> ... </JDBCDriver> ... </DataBase> Argomenti correlati • Creazione di una connessione JDBC con il file SBO 10.2 Informazioni sui driver ODBC DataDirect Il livello di accesso ai dati consente l'utilizzo di driver ODBC DataDirect 7.0 per database MS SQL Server su tutte le piattaforme UNIX. Questi driver possono essere senza marchio o con marchio. I driver DataDirect con marchio vengono forniti come parte della piattaforma BI e possono essere utilizzati unicamente con le applicazioni SAP BusinessObjects, come SAP BusinessObjects Web Intelligence. Tali driver si trovano nella directory dir-install-boe/enterprise_xi40/nome- 170 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati piattaforma/odbc/lib, in cui dir-install-boe corrisponde alla directory di installazione della piattaforma BI e nome-piattaforma al nome della piattaforma UNIX. I database MS SQL Server possono utilizzare un driver ODBC DataDirect 7.0 o un driver ODBC DataDirect 7.0 con marchio. Possono inoltre utilizzare la versione 6.0 SP2 del driver. Questa versione però non viene fornita con la presente versione della piattaforma. Le impostazioni predefinite di Connection Server consentono il corretto funzionamento dei driver ODBC senza marchio con le impostazioni di configurazione correnti. Se è già stato distribuito un driver nell'ambiente, sarà possibile installare il driver senza marchio senza alcuna modifica di configurazione. 10.2.1 Abilitazione dell'uso di driver DataDirect con marchio Per utilizzare il driver con marchio, è necessario accertarsi che l'accesso ai dati sia configurato correttamente. 1. Selezionare la directory che contiene il file sqlsrv.sbo. In UNIX il file di configurazione si trova nella directory dir-installazione-connectionser ver/connectionServer/odbc. 2. Utilizzare un editor XML per aprire il file sqlsrv.sbo da modificare. 3. Individuare la sezione Defaults. L'impostazione predefinita del parametro Use DataDirect OEM Driver è No. Ciò significa che l'accesso ai dati è configurato per il funzionamento con driver senza marchio per impostazione predefinita. 4. Impostare il parametro Use DataDirect OEM Driver su Yes e salvare il file. 5. Aggiungere il percorso seguente alla variabile di ambiente LD_LIBRARY_PATH: dir-installaz-boe/enterprise_xi40/nome-piattaforma/odbc/lib 6. Configurare l'ambiente modificando il file env.sh nella directory dir-installaz-boe/setup e specificarne l'origine. Ad esempio: DEFAULT_ODBCFILE="${BOBJEDIR}enterprise_xi40/"odbc.ini Export DEFAULT_ODBCFILE ODBC_HOME="${BINDIR}odbc" Export ODBC_HOME ODBCINI="${BOBJEDIR}enterprise_xi40/"odbc.ini export ODBCINI Nota: DEFAULT_ODBCFILE può puntare a qualsiasi file contenente i dettagli di connessione per i driver con marchio. 7. Configurare l'origine dati modificando il file odbc.ini. Ad esempio: [ODBC Data Sources] sql2008=sql=DataDirect 7.0 SQL Server Native Wire Protocol Driver=/.../enterprise_xi40/linux_x64/odbc/lib/CRsqls24.so 171 2013-07-02 Configurazione dei parametri dei driver di accesso ai dati Description=DataDirect 7.0 SQLServer Wire Protocol Driver Address=10.180.0.197,1433 Database=bodb01 8. Avviare Connection Server da CMC. Connection Server è in grado di creare una connessione ai database MS SQL Server con i driver DataDirect ODBC con marchio. Esempio: Di seguito viene riportato un estratto del file sqlsrv.sbo predefinito. <Defaults> <Parameter <Parameter <Parameter <Parameter <Parameter ... <Parameter </Defaults> ... 172 Name="Family">Microsoft</Parameter> Name="SQL External File">sqlsrv</Parameter> Name="SQL Parameter File">sqlsrv</Parameter> Name="Description File">sqlsrv</Parameter> Name="Strategies File">sqlsrv</Parameter> Name="Use DataDirect OEM Driver" Platform="Unix">No</Parameter> 2013-07-02 Riferimento ai parametri SBO Riferimento ai parametri SBO 11.1 Struttura dei file SBO Per ogni driver di accesso ai dati supportato esiste un file <driver>.sbo. Ogni file <driver>.sbo è suddiviso nelle seguenti sezioni: 173 Sezione del file Descrizione Defaults Questa sezione contiene i parametri di configurazione predefiniti validi per tutto il middleware del database che utilizza il driver di accesso ai dati. Tali parametri sovrascrivono eventuali valori corrispondenti impostati nel middleware del database. 2013-07-02 Riferimento ai parametri SBO Sezione del file Descrizione Questa sezione contiene un elemento subordinato DataBaseper ciascun middleware del database supportato dal driver di accesso ai dati. Ogni elemento DataBase può contenere i seguenti elementi o attributi: • Active: attributo che specifica se il supporto middleware è attivato o meno. Il valore è YES o NO. • Name: attributo che specifica il nome del middleware supportato dal driver di accesso ai dati. I valori dei nomi dei middleware impostati in questa sezione vengono visualizzati nella pagina Selezione del middleware del database nella procedura guidata di connessione. • Alias: elemento che specifica il nome delle versioni precedenti del middleware ufficialmente non più supportate dal driver di accesso ai dati ma ancora in uso. È possibile aggiungere un elemento alias per una versione precedente del middleware in modo che le connessioni esistenti possano utilizzare il driver di accesso ai dati corrente. È possibile impostare i parametri di configurazione specifici dei middleware precedenti come parametri del nuovo alias. Inoltre, è possibile creare nuove connessioni usando l'alias. • Parameter: elemento con attributo Name e un valore che viene applicato specificamente a un middleware. I valori impostati per i parametri elencati in questa sezione sovrascrivono i valori impostati per gli stessi parametri nella sezione Defaults. Databases Nota: I parametri booleani accettano sia valori true/false che valori yes/no. I valori non dipendono dalla condizione. 11.2 Descrizione dei parametri SBO I parametri di configurazione sono riportati in base a quanto segue: • 174 Comune 2013-07-02 Riferimento ai parametri SBO In questa sezione vengono descritti i parametri dei file SBO condivisi dalle diverse tecnologie di database. Le altre categorie descrivono i parametri specifici della tecnologia di database o del livello di rete che rappresentano. • • • • • • • • • JavaBean JCO JDBC OData ODBC OLE DB OLE DB per OLAP Sybase ASE/CTL Teradata Ogni parametro viene visualizzato con le seguenti informazioni: • Esempio di visualizzazione del parametro nel file XML • Descrizione del parametro • Valori che è possibile impostare per il parametro • Valore predefinito del parametro Argomenti correlati • Parametri SBO comuni • Parametri SBO JavaBean • Parametri SBO JCO • Parametri SBO JDBC • Parametri SBO OData • Parametri SBO ODBC • Parametri SBO OLE DB • Parametri SBO OLAP OLE DB • Parametri SBO Sybase • Parametri SBO Teradata 11.3 Parametri SBO comuni Questi parametri SBO sono per la maggior parte utilizzati in tutti i driver di accesso ai dati. Sono definiti nella sezione Defaults dei file. Alcuni di questi parametri SBO sono inoltre definiti nel file cs.cfg. I valori impostati nella sezione Defaults hanno la precedenza sui valori impostati nel file cs.cfg. 175 2013-07-02 Riferimento ai parametri SBO 11.3.1 Array Bind Available <Parameter Name="Array Bind Available">No</Parameter> Specifica se il database supporta il collegamento delle matrici. Descrizione Il collegamento delle matrici consente di ottimizzare le prestazioni delle query SQL di aggiornamento. Yes: il database supporta il collegamento delle matrici. Valori No: il database non supporta il collegamento delle matrici. Predefinita Valore impostato nel file cs.cfg. 11.3.2 Array Bind Size Limitazione: gli strumenti client della piattaforma SAP BusinessObjects BI non utilizzano questo parametro. <Parameter Name="Array Bind Size">5</Parameter> Descrizione Specifica il numero di righe esportate con ciascuna query INSERT. Valori Numero di righe esportate con ciascuna query INSERT (intero). Predefinita Valore impostato nel file cs.cfg. 11.3.3 Array Fetch Available 176 2013-07-02 Riferimento ai parametri SBO <Parameter Name="Array Fetch Available">No</Parameter> Specifica se in Connection Server è abilitata la ricerca per il recupero delle matrici. Descrizione Il recupero delle matrici consente di ottimizzare le prestazioni recuperando i risultati SQL per sezione. Yes: il recupero delle matrici è supportato. Valori No: il recupero delle matrici non è supportato. Predefinita Valore impostato nel file cs.cfg. 11.3.4 Dimensioni array fetch <Parameter Name="Array Fetch Size">10</Parameter> 177 2013-07-02 Riferimento ai parametri SBO Specifica il numero di righe di dati recuperati per sezione. Connection Server fornisce funzionalità di array fetch in qualsiasi modalità di distribuzione. Promemoria: il valore Dimensioni array fetch viene propagato sul middleware del database se supporta l'array fetch. Il numero ottimale dipende dalle prestazioni del sistema: • Se il numero è basso, il sistema recupera piccole quantità di dati molte volte. Ciò può compromettere le prestazioni del sistema. • Descrizione se il numero è alto, il sistema esegue un numero minore di operazioni di recupero, ma richiede più memoria per ogni operazione. Avvertenza: verificare l'adeguatezza del valore Dimensioni array fetch poiché può influire sulle prestazioni del sistema, soprattutto in accesso remoto; ad esempio, quando vengono stabilite connessioni al sistema SAP ERP in modalità di distribuzione del livello Web. Per le connessioni OLAP in accesso remoto (origini dati Essbase, MS Analysis Services e SAP BW tramite Connection Server a 32 bit), impostare la dimensione array fetch su un valore ottimale in base al numero di colonne nei report da creare (ad esempio 100 se il numero di colonne è elevato e 250 se il numero è basso). In modalità di distribuzione del livello Web, il parametro Dimensione blocco HTTP può essere di aiuto anche per regolare la prestazione riducendo il numero di chiamate dati fra il client e il server. Consultare il Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence per maggiori informazioni sul raggruppamento HTTP. Numero di righe recuperate per sezione (intero). Valori 1 specifica che il recupero delle matrici è disabilitato. 0 specifica che il driver decide quali dimensioni dell'array fetch utilizzare. Questo valore è valido solo per i driver JDBC. Predefinita Valore impostato nel file cs.cfg. Argomenti correlati • Restrizioni dei driver SAP ERP 178 2013-07-02 Riferimento ai parametri SBO 11.3.5 BigDecimal Max Display Size <Parameter Name="BigDecimal Max Display Size">128</Parameter> Descrizione Specifica la dimensione massima di visualizzazione dei dati recuperati con il tipo di carattere BigDecimal. Valori La dimensione di visualizzazione (intero in byte). Predefinita Nessun valore predefinito. 11.3.6 Binary Max Length <Parameter Name="Binary Max Length">32768</Parameter> Descrizione Specifica la lunghezza massima delle colonne di tabella il cui tipo è: • binary e il cui valore MaxLength è Max o per cui non viene fornita alcuna lunghezza fissa per le origini dati OData • base64Binary ed hexBinary per le origini dati XML I dati restituiti vengono troncati se sono in numero maggiore del valore specificato. Predefinito 32768 Argomenti correlati • Driver OData • Driver XML • Driver di servizio Web 179 2013-07-02 Riferimento ai parametri SBO 11.3.7 Bucket Split Size <Parameter Name="Bucket Split Size">25000</Parameter> Specifica il numero di record ordinati nella memoria prima che vengano scritti sul disco locale. I seguenti driver di accesso ai dati utilizzano Bu cket Split Size quando eseguono le operazioni ORDER BY, GROUP BY o DISTINCT: • CSV OpenDriver • Driver OData • Driver SAP ERP • Driver XML e di servizio Web Descrizione Nota: È possibile configurare il percorso della directory nel file cs.cfg con il parametro Temp Data Dir quando nel sistema operativo non è specificata alcuna cartella temporanea. Ciò può avvenire con i sistemi operativi Linux. Bucket Split Size ha effetto sul consumo di memoria. Se le dimensioni della memoria principale sono troppo piccole, il valore del parametro viene ignorato. Predefinito 25000 Argomenti correlati • Disco locale utilizzato come cache per le operazioni di ordinamento Il CSV OpenDriver e i driver OData, SAP ERP, XML e di servizio Web possono utilizzare il disco locale come cache per le righe ordinate. • Temp Data Dir 11.3.8 Catalog Separator <Parameter Name="Catalog Separator">.</Parameter> 180 2013-07-02 Riferimento ai parametri SBO Descrizione Specifica il carattere separatore utilizzato tra gli elementi degli identificatori del database (qualificatori, proprietari, tabelle e colonne). Ad esempio, nome_database.nome_tabella.nome_colonna. Valori Carattere separatore da utilizzare. Normalmente è un punto. Predefinito Se non viene specificato, Connection Server utilizza il separatore utilizzato nel middleware del database. 11.3.9 CharSet Table <Parameter Name="CharSet Table">sybase</Parameter> Descrizione Specifica il nome della tabella utilizzata per il mapping del set di caratteri tra il sistema operativo e il middleware. Valori Il nome del file CRS. Impostazione predefinita Nessuna impostazione predefinita. 11.3.10 Description File <Parameter Name="Description File">oracle</Parameter> Descrizione 181 Nota: Non modificare questo parametro. Specifica il nome del file COD, che contiene le etichette dei campi di immissione della procedura guidata di connessione. 2013-07-02 Riferimento ai parametri SBO 11.3.11 Dictionary Transaction Mode <Parameter Name="Dictionary Transaction Mode">Transactional</Parameter> Specifica che il driver di accesso ai dati esegue una query sui metadati in modalità transazione. Descrizione Valori Nota: I driver di accesso ai dati eseguono query sui metadati in modalità AutoCommit per impostazione predefinita. Per modificare la configurazione di un driver in transazionale, aggiungere il parametro alla sezione appropriata del file di configurazione SBO (Defaults o qualsiasi sezione Database). Transactional 11.3.12 Driver Capabilities <Parameter Name="Driver Capabilities">Procedures , Query</Parameter> Funzionalità del driver, ovvero se è in grado di accedere a stored procedure e query disponibili nel software del database. Questo parametro viene impostato utilizzando la procedura guidata di connessione. Nel parametro è possibile includere entrambi i valori. Descrizione 182 Nota: Questo parametro deve essere impostato su Procedures per un driver JavaBean. Per quanto riguarda le applicazioni SAP BusinessObjects, la funzionalità di un driver JavaBean viene definita come stored procedure. 2013-07-02 Riferimento ai parametri SBO Procedures: il driver può utilizzare le procedure archiviate nel database per recuperare i dati. Valori Query: il driver può utilizzare un linguaggio di query come SQL per recuperare i dati. Impostazione predefinita Query 11.3.13 Driver Name <Parameter Name="Driver Name">Adaptive Server IQ</Parameter> Specifica il nome del driver visualizzato nella scheda Drivers dell'amministratore dell'origine dati ODBC in Microsoft Windows. Descrizione Questo parametro è specifico di ODBC e consente di filtrare i driver presenti nell'elenco dei nomi delle origini dati (DSN) ODBC. Il nome del driver. Valori Nota: è possibile utilizzare un'espressione regolare basata sulla sintassi regexp GNU da PERL. Predefinita Nessun valore predefinito. 11.3.14 Escape Character <Parameter Name="Escape Character">/</Parameter> Descrizione 183 Specifica il carattere da utilizzare per le stringhe di uscita dei caratteri speciali, ad esempio i motivi. 2013-07-02 Riferimento ai parametri SBO Valori Carattere da utilizzare come carattere di uscita. Predefinito Se non viene specificato, Connection Server recupera il valore dal middleware. 11.3.15 Extensions <Parameter Name="Extensions">oracle10,oracle,jdbc</Parameter> Nota: Non modificare questo parametro. Descrizione Specifica l'elenco dei nomi possibili per i file PRM e RSS dei driver di accesso ai dati. Specifica inoltre i nomi possibili delle directory in cui è possibile memorizzare i file JAR. Argomenti correlati • Creazione di una connessione JDBC con Extensions 11.3.16 Family <Parameter Name="Family">Sybase</Parameter> Nota: Non modificare questo parametro. Descrizione 184 Specifica la famiglia del motore di database da visualizzare nella pagina "Selezione del middleware del database" della procedura guidata di connessione. L'insieme del middleware che corrisponde alla licenza dell'utente viene visualizzato in questa pagina in una struttura ad albero. 2013-07-02 Riferimento ai parametri SBO 11.3.17 Force Execute <Parameter Name="Force Execute">Never</Parameter> Descrizione Nota: Non modificare questo parametro. Specifica se la query SQL viene eseguita prima del recupero delle descrizioni dei risultati. Never: la query SQL non viene mai eseguita prima del recupero delle descrizioni dei risultati. Valori Procedures: la query SQL viene eseguita prima del recupero delle descrizioni dei risultati ma solo per le stored procedure. Always: la query SQL viene sempre eseguita prima del recupero delle descrizioni dei risultati. Predefinito Never 11.3.18 Identifier Case <Parameter Name="Identifier Case">LowerCase</Parameter> Descrizione 185 Specifica in che modo il database gestisce il comportamento delle maiuscole/minuscole degli identificatori semplici. 2013-07-02 Riferimento ai parametri SBO CaseSensitive: il database tratta gli identificatori SQL con lettere maiuscole e minuscole come elementi per cui è valida la distinzione tra maiuscole e minuscole. LowerCase: il database tratta gli identificatori SQL con lettere maiuscole e minuscole come elementi per cui non è valida la distinzione tra maiuscole e minuscole e li archivia al minuscolo. Valori MixedCase: il database tratta gli identificatori SQL con lettere maiuscole e minuscole come elementi per cui non è valida la distinzione tra maiuscole e minuscole e li archivia al maiuscolo e al minuscolo. UpperCase: il database tratta gli identificatori SQL con lettere maiuscole e minuscole come elementi per cui non è valida la distinzione tra maiuscole e minuscole e li archivia al maiuscolo. 11.3.19 Identifier Quote String <Parameter Name="Identifier Quote String">&quot;</Parameter> Descrizione Specifica il carattere utilizzato per racchiudere gli identificatori del database tra virgolette. Valori Il carattere utilizzato per racchiudere gli identificatori del database tra virgolette, normalmente le virgolette (&quot;). Impostazione predefinita Se non diversamente specificato, Connection Server recupera le informazioni dal middleware del database. 11.3.20 Include Synonyms <Parameter Name="Include Synonyms">False</Parameter> 186 2013-07-02 Riferimento ai parametri SBO Descrizione Valori Specifica se le colonne per Oracle Synonyms vengono recuperate dal database Oracle. Questa opzione è valida per le connessioni Oracle tramite JDBC o i livelli di rete Oracle OCI. True: le colonne per Oracle Synonyms vengono recuperate e visualizzate come colonne di tabella. False: le colonne per Oracle Synonyms non vengono recuperate. Predefinito False 11.3.21 Integer Max Length <Parameter Name="Integer Max Length">18</Parameter> Specifica la lunghezza massima delle colonne di tabella il cui tipo incorporato XML è integer, nonPositiveInteger, negativeInteger, noNegativeInteger e positiveInteger. Descrizione I dati restituiti vengono troncati se sono in numero maggiore del valore specificato. Integer Max Length si applica alle origini dati XML e ai servizi Web. Predefinito 18 Argomenti correlati • Driver XML - Configurazione della dimensione massima delle colonne • Driver di servizio Web - Configurazione della dimensione massima delle colonne 11.3.22 Introscope Available <Parameter Name="Introscope Available">True</Parameter> 187 2013-07-02 Riferimento ai parametri SBO Descrizione Nota: Non modificare questo parametro. Specifica se il monitoraggio delle prestazioni tramite CA Wily Introscope è attivato per il driver. True: il monitoraggio del driver è attivato. Valori False: il monitoraggio del driver non è attivato. Impostazione predefinita Il parametro viene impostato su False per tutti i driver nel file cs.cfg. Il monitoraggio viene attivato solo per le connessioni SAP HANA nel file newdb.sbo. 11.3.23 Max Rows Available <Parameter Name="Max Rows Available">No</Parameter> Descrizione Specifica se il driver è in grado di limitare il numero massimo di righe che possono essere recuperate da un'origine dati. Yes: il numero massimo di righe può essere limitato. Valori No: il numero massimo di righe non può essere limitato. Predefinita No 11.3.24 Native Int64 Available <Parameter Name="Native Int64 Available">False</Parameter> 188 2013-07-02 Riferimento ai parametri SBO Nota: Non modificare questo parametro. Descrizione Indica se il middleware è in grado di gestire direttamente gli interi a 64 bit. True: il middleware è in grado di gestire gli interi a 64 bit. Valori False: il livello di accesso ai dati emula i metodi Int64. Predefinito False 11.3.25 Optimize Execute <Parameter Name="Optimize Execute">False</Parameter> Descrizione Valori Specifica se Connection Server ottimizza l'esecuzione delle query SQL. Questo parametro è supportato solo dai driver Oracle e ODBC. True: le query SQL vengono ottimizzate durante l'esecuzione ogni volta che sia possibile. False: l'esecuzione delle query SQL non viene ottimizzata. Predefinito False 11.3.26 Owners Available <Parameter Name="Owners Available">No</Parameter> 189 2013-07-02 Riferimento ai parametri SBO Specifica se i driver di accesso ai dati gestiscono i proprietari dei database. Descrizione Nota: Per impostare manualmente i proprietari della tabella in Information Design Tool, impostare questo parametro su Sì. Sì: i proprietari sono supportati. Valori No: i proprietari non sono supportati. Predefinito Non specificato Connection Server recupera queste informazioni dal middleware del database. 11.3.27 Qualifiers Available <Parameter Name="Qualifiers Available">No</Parameter> Specifica se i driver di accesso ai dati gestiscono i qualificatori dei database. Descrizione Nota: Per impostare manualmente i qualificatori della tabella in Information Design Tool, impostare questo parametro su Sì. Yes: i qualificatori sono supportati. Valori No: i qualificatori non sono supportati. Predefinito Non specificato Connection Server recupera queste informazioni dal middleware del database. 11.3.28 Query TimeOut Available 190 2013-07-02 Riferimento ai parametri SBO <Parameter Name="Query TimeOut Available">False</Parameter> Descrizione Specifica se il middleware del database supporta il timeout di una query, ovvero se è possibile annullare l'esecuzione di una query dopo che è trascorso un determinato periodo di tempo. True: il middleware del database gestisce i timeout delle query. Valori False: il middleware del database non gestisce i timeout delle query. Predefinito False 11.3.29 Quote Identifiers <Parameter Name="Quote Identifiers">True</Parameter> Descrizione Specifica se l'identificatore della stored procedure supporta le virgolette. True: le virgolette sono supportate. Valori False: le virgolette non sono supportate. Predefinito True 11.3.30 Skip SAML SSO <Parameter Name="Skip SAML SSO">False</Parameter> 191 2013-07-02 Riferimento ai parametri SBO Specifica se l'implementazione SAML del Single Sign On (SSO) viene ignorata quando ci si connette al database SAP HANA. Descrizione Per ulteriori informazioni sul Single Sign On, fare riferimento al Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. True: SAML viene ignorato. Valori False: SAML viene utilizzato per primo. Predefinito False 11.3.31 SQL External File <Parameter Name="SQL External File">filename</Parameter> Descrizione Nota: Non modificare questo parametro. Il file esterno SQL contiene dettagli di configurazione utilizzati dal livello di accesso ai dati. 11.3.32 SQL Parameter File <Parameter Name="SQL Parameter File">oracle</Parameter> Il nome del file in cui sono memorizzati i parametri del database. L’estensione di questo file è .prm. Descrizione È necessario assicurarsi che il file si trovi nella stessa directory del file di configurazione SBO. Valori 192 Vedere l'elenco dei valori nel file SBO. 2013-07-02 Riferimento ai parametri SBO Predefinita I valori indicati. 11.3.33 SSO Available <Parameter Name="SSO Available">False</Parameter> Specifica se è supportato il Single Sign On (SSO). Descrizione Per ulteriori informazioni sul Single Sign On, fare riferimento al Manuale dell'amministratore della piattaforma SAP BusinessObjects Business Intelligence. True: il Single Sign On è supportato. Valori False: il Single Sign On non è supportato. Predefinito False 11.3.34 Strategies File <Parameter Name="Strategies File">oracle</Parameter> Specifica il nome, senza estensione, del file di strategia (.stg). Descrizione 193 Questo file contiene le strategie esterne utilizzate dallo strumento di progettazione degli universi per la creazione automatica degli universi. I file di strategia si trovano nella stessa directory del file SBO. 2013-07-02 Riferimento ai parametri SBO db2 per i driver di accesso ai dati IBM DB2 informix per IBM Informix oracle per Oracle Valori sqlsrv per MS SQL Server sybase per Sybase teradata per Teradata Predefinita I valori indicati. 11.3.35 Lunghezza massima <Parameter Name="Lunghezza massima">32768</Parameter> Specifica la lunghezza massima della stringa per le colonne della tabella mappate ai parametri della funzione ABAP la cui lunghezza del valore è uguale a zero. Descrizione Specifica anche la lunghezza massima delle colonne di tabella il cui tipo è il seguente: • String e il cui valore MaxLength è Max per le origini dati OData • String e uno qualsiasi dei seguenti per le origini dati XML: anyURI, QName, NOTATION, duration, gYearMonth, gYear, gMonthDay, gDay, gMonth, TYPE_NORMALIZEDSTRING, token, language, Name, NCName, XSD_TYPE_ID, IDREF, IDREFS, ENTITY, ENTITIES I dati restituiti vengono troncati se sono in numero maggiore del valore specificato. Predefinito 32768 Argomenti correlati • Driver OData • Driver SAP ERP - Accesso alle funzioni ABAP • Driver XML 194 2013-07-02 Riferimento ai parametri SBO • Driver di servizio Web 11.3.36 Temp Data Dir <Parameter Name="Temp Data Dir">C:\temp\</Parameter> Specifica il percorso della directory dei dati temporanei scritti sul disco. Utilizzare questo parametro se nel sistema operativo non è specificata una cartella temporanea predefinita, ad esempio C:\Utenti\Nome\App Data\Local\Temp. Descrizione Il parametro Temp Data Dir può essere utilizzato dai seguenti driver di accesso ai dati: • CSV OpenDriver • Driver OData • Driver SAP ERP • Driver XML e di servizio Web Quando il driver esegue un'operazione ORDER BY, GROUP BY o DISTINCT, i dati vengono scritti in questa cartella se il numero di record da ordinare supera il valore del parametro Bucket Split Size. Impostazione predefinita Il parametro è stato modificato in commento. Rimuovere la sintassi del commento per abilitare il parametro. Argomenti correlati • Disco locale utilizzato come cache per le operazioni di ordinamento Il CSV OpenDriver e i driver OData, SAP ERP, XML e di servizio Web possono utilizzare il disco locale come cache per le righe ordinate. • Bucket Split Size 11.3.37 Transactional Available <Parameter Name="Transactional Available">Yes</Parameter> 195 2013-07-02 Riferimento ai parametri SBO Specifica se le operazioni SQL eseguite a fronte del database hanno luogo come transazioni in blocco o in modo individuale. Descrizione Per impostazione predefinita, questo parametro non è elencato nel file SBO. Aggiungerlo al file SBO se il driver di accesso ai dati non supporta la modalità per transazioni. Yes: le operazioni a fronte del database sono eseguite in blocco quando vengono inviate. Valori No: ogni istruzione SQL viene immediatamente salvata, quindi la funzione Autocommit viene disattivata. Nota: non utilizzare un driver con Transactional Available=No per accedere al repository SAP BusinessObjects. Predefinito Yes. Valore impostato nel file cs.cfg. Argomenti correlati • Errore di connessione in caso di mancato supporto della modalità transazione • Per fare in modo che le connessioni salesforce.com funzionino con Universe Design Tool 11.3.38 Tipo <Parameter Name="Type">Relational</Parameter> Descrizione Nota: Non modificare questo parametro. Specifica il tipo di origine dati. 11.3.39 Unicode <Parameter Name="Unicode">UTF8</Parameter> 196 2013-07-02 Riferimento ai parametri SBO Specifica se il driver di accesso può utilizzare la configurazione Unicode del middleware cliente. Descrizione Questo parametro appare come predefinito del driver nel file cs.cfg. Il relativo valore è applicabile a tutti i driver di accesso ai dati. Per impostazione predefinita, questo parametro non è elencato nel file SBO. Se si desidera sostituire il valore predefinito, è necessario aggiungerlo alla sezione Defaults del file SBO per il driver di accesso ai dati di destinazione. UTF8: codifica UCS/Unicode Transformation Format a 8 bit. Valori CharSet: codifica del set di caratteri. UCS2: codifica Universal Character Set a 2 byte. Predefinita Valore impostato nel file cs.cfg. 11.3.40 URL Format <Parameter Name="URL Format ">string</Parameter> Specifica il formato dell'URL. La specifica JDBC non indica il formato della stringa di connessione richiesta. I fornitori utilizzano tipi diversi di formati dell'URL, ad esempio: • Fornitore MySQL: jdbc:mysql://$DATASOURCE$/$DATABASE$ Descrizione • Fornitore Oracle: jdbc:oracle:thin:@$DATASOURCE$:$DATABASE$ Nota: Questo parametro è supportato solo dai file dei driver JDBC e JavaBean. 197 Valori Il formato dell'URL Predefinita Nessun valore predefinito. 2013-07-02 Riferimento ai parametri SBO 11.3.41 XML Max Size <Parameter Name="XML Max Size">65536</Parameter> Descrizione Specifica la dimensione massima dei dati recuperati in formato XML. Valori Dimensione massima consentita per i dati XML, in byte. Predefinito Varia in base al database. 11.4 Parametri SBO JavaBean Questi parametri si applicano al file SBO JavaBean e vengono utilizzati per configurare una connessione JavaBean. Questi parametri vengono definiti nel file \\dir-installazione-connectionserver\connec tionServer\javabean\javabean.sbo. 11.4.1 JavaBean Class <Parameter Name="JavaBean Class">string</Parameter> Definisce il punto di ingresso del JavaBean utilizzato dall'applicazione SAP BusinessObjects. 198 Descrizione Il punto di ingresso è la definizione di una classe java che si estende dall'interfaccia Bean specificata fino al pacchetto com.businessobje cts. Valori Un nome completo di classe JavaBean. 2013-07-02 Riferimento ai parametri SBO Predefinita Nessun valore predefinito. 11.5 Parametri SBO JCO Questi parametri si applicano alla tecnologia di database SAP ERP. Vengono utilizzati per configurare una connessione al sistema SAP ERP e sono definiti nel file \\dir-installazione-connectionserver\connectionSer ver\jco\jco.sbo. 11.5.1 ERP Max Rows <Parameter Name="ERP Max Rows">2147483647</Parameter> Descrizione Specifica il numero massimo di righe che può essere restituito da una query a un InfoSet o una query SAP senza filtro. Valori Un intero pari o inferiore a 2147483647. Predefinito 2147483647 Argomenti correlati • Driver SAP ERP 11.6 Parametri SBO JDBC Questi parametri si applicano al file SBO JDBC e vengono utilizzati per configurare una connessione JDBC. I parametri vengono definiti nei file SBO della directory \\dir-installazione-connectionser ver\connectionServer\jdbc. 199 2013-07-02 Riferimento ai parametri SBO 11.6.1 Connection Shareable <Parameter Name="Connection Shareable">False</Parameter> Nota: Non modificare questo parametro. Descrizione Specifica se una connessione di un connection pool può essere condivisa tra diversi richiedenti. Viene utilizzato insieme al parametro Shared Connection. True: la connessione può essere condivisa tra più utenti. Valori False: la connessione non può essere condivisa tra gli utenti Predefinito False Argomenti correlati • Shared Connection 11.6.2 Escape Character Available <Parameter Name="Escape Character Available">True</Parameter> Descrizione Indica se il livello di rete JDBC gestisce una clausola escape dopo l'espressione like della query SQL. Tale clausola consente di specificare un carattere che escluda caratteri specifici come la sottolineatura (_). True: è supportata una clausola escape. Valori False: non è supportata una clausola escape. Predefinito 200 True 2013-07-02 Riferimento ai parametri SBO 11.6.3 ForeignKeys Available <Parameter Name="ForeignKeys Available">True</Parameter> Specifica se è possibile recuperare chiavi esterne delle tabelle di database. Descrizione True: è possibile recuperare chiavi esterne. Valori False: non è possibile recuperare chiavi esterne. Predefinito True 11.6.4 Get Extended Column <Parameter Name="Get Extended Column">No</Parameter> Nota: Non modificare questo parametro. Descrizione Specifica se il livello di accesso ai dati utilizza la stored procedure ge tExtendedColumns fornita da Data Federator Query Server per recuperare le colonne di input. Yes: viene utilizzato getExtendedColumns. Valori No: getExtendedColumns non viene utilizzato. Predefinita 201 No 2013-07-02 Riferimento ai parametri SBO 11.6.5 JDBC Class <Parameter Name="JDBC Class">string</Parameter> Descrizione Valori Classe Java completa del driver JDBC. Dipende dal fornitore o dall'origine dati, ad esempio: • oracle.jdbc driver Oracle per Oracle • Predefinita com.ibm.db2.jcc.DB2Driver per DB2 Nessun valore predefinito. 11.6.6 PrimaryKey Available <Parameter Name="PrimaryKey Available">True</Parameter> Descrizione Indica se è possibile recuperare le chiavi primarie delle tabelle di database. True: è possibile recuperare le chiavi primarie. Valori False: non è possibile recuperare le chiavi primarie. Predefinito True 11.6.7 PVL Available <Parameter Name="PVL Available">True</Parameter> 202 2013-07-02 Riferimento ai parametri SBO Descrizione Specifica se la connessione supporta la funzionalità Impostazioni internazionali di visualizzazione preferite. è supportato solo dalle connessioni SAP HANA in questa versione. True: PVL è supportato. Valori False: PVL non è supportato. 11.6.8 Shared Connection <Parameter Name="Shared Connection">False</Parameter> Nota: Non modificare questo parametro. Descrizione Specifica se la connessione richiesta di un connection pool è condivisa. Viene utilizzato insieme al parametro Connection Shareable. Non viene preso in considerazione se il parametro Max Pool Time di cs.cfg è impostato su 0. True: la connessione è condivisa. Valori False: la connessione non è condivisa. Predefinito False Argomenti correlati • Connection Shareable • Max Pool Time 11.6.9 JDBC ResultSet Type <Parameter Name="JDBC ResultSet Type">1003</Parameter> 203 2013-07-02 Riferimento ai parametri SBO Nota: È necessario utilizzare questo parametro insieme a JDBC ResultSet Concurrency. Questa condizione non è obbligatoria. Descrizione Specifica il valore dell'argomento resultSetType del metodo Java createStatement. Questo metodo appartiene all'interfaccia java.sql.Connection. Questo parametro viene aggiunto per creare un oggetto Statement predefinito e regolare le prestazioni della connessione. Valori Vengono importati valori Java standard o valori specifici del database. I valori devono essere numeri interi. Argomenti correlati • createStatement method • ResultSet interface 11.6.10 JDBC ResultSet Concurrency <Parameter Name="JDBC ResultSet Concurrency">1007</Parameter> Nota: È necessario utilizzare questo parametro insieme a JDBC ResultSet Type. Questa condizione non è obbligatoria. Descrizione Specifica il valore dell'argomento resultSetConcurrency del metodo Java createStatement. Questo metodo appartiene all'interfaccia java.sql.Connection. Questo parametro viene aggiunto per creare un oggetto Statement predefinito e regolare le prestazioni della connessione. Valori Vengono importati valori Java standard o valori specifici del database. I valori devono essere numeri interi. Argomenti correlati • createStatement method • ResultSet interface 204 2013-07-02 Riferimento ai parametri SBO 11.7 Parametri SBO OData Questi parametri vengono utilizzati per configurare connessioni a origini dati che utilizzano il protocollo OData. Questi parametri vengono definiti nel file \\dir-installazione-connectionserver\connec tionServer\odata\odata.sbo. 11.7.1 Enforce Max Protocol Version <Parameter Name="Enforce Max Protocol Version">Yes</Parameter> Specifica se il driver invia la versione supportata del protocollo OData al provider OData. Descrizione In caso affermativo, il provider OData può decidere se rispondere al driver nel protocollo specificato. Questo parametro può essere utile quando la piattaforma di BI si connette a un provider che utilizza il protocollo OData 3.0. Yes: il driver invia la versione supportata del protocollo OData. Valori No: il driver non invia la versione supportata del protocollo OData. Predefinita Yes 11.8 Parametri SBO ODBC Questi parametri si applicano al livello di rete ODBC e vengono utilizzati per configurare una connessione ODBC. I parametri vengono definiti nei file SBO della sottodirectory \\dir-installazione-connection server\connectionServer\odbc. 205 2013-07-02 Riferimento ai parametri SBO 11.8.1 CharSet <Parameter Name="CharSet">ISO88591</Parameter> Descrizione Nota: Non modificare questo parametro. Specifica il set di caratteri dei dati restituiti dal middleware del database. Valori ISO88591: il valore predefinito del set di caratteri specificato per HP Neoview su UNIX. Impostazione predefinita Se non diversamente indicato, Connection Server utilizza il set di caratteri specificato nel middleware del database. 11.8.2 Connection Status Available <Parameter Name="Connection Status Available">True</Parameter> Descrizione Specifica se il middleware è in grado di rilevare una connessione non valida (funzione di ping). True: il middleware è in grado di rilevare una connessione non valida. 206 Valori False: il middleware non è in grado di rilevare una connessione non valida. Predefinito Valore impostato nel middleware. 2013-07-02 Riferimento ai parametri SBO 11.8.3 Cost Estimate Available <Parameter Name="Cost Estimate Available">False</Parameter> Descrizione Specifica se il middleware del database supporta la stima del costo dell'esecuzione della query SQL. Questo parametro viene utilizzato solo con il database Teradata. True: il middleware supporta la stima di costi. Valori False: il middleware non supporta la stima di costi. Predefinito False 11.8.4 Empty String <Parameter Name="Empty String">EmptyString</Parameter> Descrizione Specifica che determinate funzioni, ad esempio le tabelle SQL, ricevono una stringa vuota o un puntatore nullo per sostituire i parametri mancanti. NullString: viene utilizzata una stringa null. Valori EmptyString: viene utilizzata una stringa vuota. Impostazione predefinita EmptyString 11.8.5 ODBC Cursors 207 2013-07-02 Riferimento ai parametri SBO <Parameter Name="ODBC Cursors">No</Parameter> Descrizione Specifica se la libreria di cursori ODBC viene utilizzata dal driver di accesso ai dati. Consente di migliorare le prestazioni del sistema. Yes: la libreria di cursori ODBC viene utilizzata dal driver di accesso ai dati. Valori No: la libreria di cursori ODBC non viene utilizzata dal driver di accesso ai dati. Predefinita Valore impostato nel file cs.cfg. 11.8.6 SQLDescribeParam Available <Parameter Name="SQLDescribeParam Available">True</Parameter> Descrizione Specifica se il middleware gestisce la funzione ODBC SQLDescribe Param. Questa funzione consente di descrivere i parametri di una stored procedure. Questo parametro viene utilizzato solo per il database IBM Informix. True: la funzione SQLDescribeParam è disponibile. Valori False: la funzione SQLDescribeParam non è disponibile. Predefinito Valore impostato nel middleware del database. 11.8.7 SQLMoreResults Available <Parameter Name="SQLMoreResults Available">True</Parameter> 208 2013-07-02 Riferimento ai parametri SBO Specifica se il middleware gestisce la funzione ODBC SQLMoreRe sults. Descrizione Questa funzione consente di recuperare più insiemi di risultati dall'esecuzione SQL, se presenti. Questo parametro è supportato solo dai driver ODBC. True: la funzione SQLMoreResults è supportata. Valori False: la funzione SQLMoreResults non è supportata. Predefinito Valore impostato nel middleware. 11.8.8 Use DataDirect OEM Driver <Parameter Name="Use DataDirect OEM Driver">No</Parameter> Descrizione Specifica se le connessioni a MS SQL Server possono utilizzare i driver ODBC DataDirect con marchio. Yes: la connessione può utilizzare il driver con marchio. Valori No: la connessione non può utilizzare il driver con marchio. Predefinita No Argomenti correlati • Informazioni sui driver ODBC DataDirect 11.8.9 V5toV6DriverName <Parameter Name="V5toV6DriverName">{Informix 3.34 32 BIT}</Parameter> 209 2013-07-02 Riferimento ai parametri SBO Descrizione Specifica la regola di conversione da Informix Connecta Informix ODBC. Il valore di questo parametro determina quale driver Informix deve essere utilizzato per definire il nome dell'origine dati (DSN) ODBC senza la stringa di connessione. Questo parametro viene utilizzato solo per il database IBM Informix. Valori Nome esatto del driver Informix installato sul computer. Predefinita Valore impostato nel file cs.cfg. 11.9 Parametri SBO OLE DB Questi parametri si applicano alla tecnologia di database OLE DB e vengono utilizzati per configurare una connessione OLE DB. I parametri vengono definiti nei file \\dir-installazione-connectionserver\connectionSer ver\oledb\oledb.sbo e \sqlsrv.sbo. 11.9.1 Enumerator CLSID <Parameter Name="Enumerator CLSID">MSDASQL Enumerator</Parameter> Descrizione Nota: Non modificare questo parametro. Specifica l'ID classe dell'enumeratore OLE DB. Questo parametro viene utilizzato solo con OLE DB. 11.9.2 Provider CLSID <Parameter Name="Provider CLSID">MSDASQL</Parameter> 210 2013-07-02 Riferimento ai parametri SBO Descrizione Nota: Non modificare questo parametro. Specifica l'ID classe del fornitore OLE DB. Questo parametro viene utilizzato solo con OLE DB. 11.10 Parametri SBO OLAP OLE DB Questi parametri si applicano alla tecnologia di database OLAP OLE DB e vengono utilizzati per configurare una connessione OLE DB per OLAP. I parametri vengono definiti nel file \\dir-installazione-connectionserver\connectionSer ver\oledb_olap\slqsrv_as.sbo. 11.10.1 MSOlap CLSID <Parameter Name="MSOlap CLSID">msolap.4</Parameter> Descrizione Nota: Non modificare questo parametro. Specifica l'ID classe del fornitore OLE DB. Questo parametro viene utilizzato solo con OLE DB per OLAP. 11.11 Parametri SBO Sybase Questi parametri si applicano al file SBO Sybase ASE/CTLIB e vengono utilizzati per configurare una connessione Sybase ASE/CTLIB. Questi parametri vengono definiti nel file \\dir-installazione-connectionserver\connec tionServer\sybase\sybase.sbo. 211 2013-07-02 Riferimento ai parametri SBO 11.11.1 Driver Behavior <Parameter Name="Driver Behavior">Dynamic</Parameter> Descrizione Specifica quale dei driver Sybase viene utilizzato. Dynamic: viene utilizzato il driver ct_dynamic. Valori Qualsiasi altro valore consente l'uso del driver CTLib. Impostazione predefinita Dynamic. 11.11.2 Password Encryption <Parameter Name="Password Encryption">True</Parameter> Descrizione Specifica se utilizzare il metodo di cifratura della password specificato nel middleware per la password immessa nella finestra di dialogo Dettagli della connessione. Questo parametro viene utilizzato solo con Sybase ed è incluso nella sezione Defaults per la compatibilità con le versioni successive. True: viene utilizzato il metodo di cifratura del middleware. Valori False: non viene utilizzato il metodo di cifratura del middleware. Predefinita Valore impostato nel file cs.cfg. 11.11.3 Quoted Identifier 212 2013-07-02 Riferimento ai parametri SBO <Parameter Name="Quoted Identifier">False</Parameter> Descrizione Specifica se sono supportati gli identificatori tra virgolette. Questo parametro è supportato solo dal middleware Sybase. True: gli identificatori tra virgolette sono supportati. Valori False: gli identificatori tra virgolette non sono supportati. Predefinito False 11.11.4 Recover Errors <Parameter Name="Recover Errors">True</Parameter> Descrizione Specifica se il driver Client Library può essere utilizzato dopo un eventuale errore del driver ct_dynamic. True: viene utilizzato il driver Client Library. Valori False: non viene utilizzato il driver Client Library. Predefinito True 11.11.5 Text Size <Parameter Name="Text Size">32768</Parameter> 213 2013-07-02 Riferimento ai parametri SBO Nota: Questo parametro non è obbligatorio. Descrizione Specifica le dimensioni massime dei dati binari o di caratteri supportati a lunghezza variabile di grandi dimensioni. I dati binari o di caratteri a lunghezza variabile di grandi dimensioni recuperati dal database Sybase CTL vengono troncati se superano i 32 Kbyte. Per evitare il troncamento dei dati, aggiungere questo parametro alla sezione Database appropriata del file di configurazione. Predefinito 32768 11.12 Parametri SBO Teradata Questi parametri si applicano ai file SBO Teradata. Questi parametri vengono utilizzati per configurare una connessione Teradata tramite JDBC o ODBC. Questi parametri sono definiti nei file \\dir-installazione-connectionserver\connection Server\jdbc\teradata.sbo e \\dir-installazione-connectionserver\connectionSer ver\odbc\teradata.sbo. 11.12.1 Replace Current Owner With Database <Parameter Name="Replace Current Owner With Database">Yes</Parameter> Descrizione Valori Specifica se il driver restituisce il nome del database corrente quando si esegue una query sull'origine dati per ottenere il proprietario corrente. Utilizzato solo con le connessioni ODBC. Yes: il proprietario corrente viene mappato al nome del database Teradata. No: il proprietario corrente viene mappato al nome utente corrente. Predefinita 214 No 2013-07-02 Riferimento ai parametri SBO Argomenti correlati • Connessioni Teradata 215 2013-07-02 Riferimento ai parametri SBO 216 2013-07-02 Configurazione dei parametri delle funzionalità dei database Configurazione dei parametri delle funzionalità dei database 12.1 Informazioni sui parametri delle funzionalità dei database I parametri delle funzionalità dei database descrivono le funzioni dei database utilizzati come origini dati per i contenuti di un universo. I parametri possono essere impostati per funzionare ai livelli seguenti: • Livello universo I parametri vengono impostati quando si crea o si modifica un universo. • Livello database I parametri vengono impostati nel file PRM del database e vengono sostituiti da eventuali impostazioni corrispondenti a livello di universo. Nota: per visualizzare gli operatori e le funzioni disponibili per il driver di accesso ai dati, aprire il file <dri ver>.prm in un editor XML. 12.2 Informazioni sui file PRM I file PRM forniscono i parametri che descrivono le funzionalità dei database utilizzati come origini dati per le applicazioni SAP BusinessObjects. Consentono ai fattori dipendenti dai database di verificare quali tipi di SQL possono essere utilizzati con l'universo, in base alla connessione e al database correlato. Per ogni driver di database esiste un file PRM corrispondente. È possibile configurare alcuni parametri delle funzionalità del database dall'interno di un universo. Le impostazioni dei file PRM vengono sostituite di conseguenza. I file PRM si trovano nelle directory dir-installazione-connectionserver\connectionSer ver\<RDBMS>, dove <RDBMS> è il nome del livello di rete o del middleware. Nota: nelle stesse directory sono disponibili anche file di testo della guida in linea in altre lingue. 217 2013-07-02 Configurazione dei parametri delle funzionalità dei database 12.2.1 Struttura dei file dei parametri PRM Per ogni driver di database supportato esiste un file PRM. Ogni file è suddiviso in sezioni, che contengono parametri specifici. Nella tabella che segue vengono descritti il contenuto e il significato di ciascuna sezione del file PRM. Sezione del file Descrizione Parametri utilizzati per descrivere le funzionalità dei database utilizzati come origini dati per gli universi, ad esempio EXT_JOIN, ORDER_BY e UNION. Questi parametri non sono direttamente disponibili nei prodotti SAP BusinessObjects. Configurazione I parametri possono essere modificati per ottimizzare le query a fronte degli universi che utilizzano il driver di accesso ai dati. Nota: tali parametri sono descritti nel capitolo successivo. 218 DateOperations Operatori di data disponibili in Universe Design Tool e in Information Design Tool, ad esempio YEAR, QUARTER, MONTH. Operators Operatori disponibili in Universe Design Tool e in Information Design Tool, ad esempio ADD, SUBSTRACT, MULTIPLY. 2013-07-02 Configurazione dei parametri delle funzionalità dei database Sezione del file Descrizione Funzioni disponibili in Universe Design Tool e in Information Design Tool, ad esempio Media, Somma, Varianza. Il testo della guida visualizzato quando si selezionano le funzioni di questa sezione in Universe Design Tool e in Information Design Tool è contenuto nel file <driver><lingua>.prm, ad esempio oracleen.prm. Questo file si trova nella stessa directory del file <driver>.prm. È possibile aprirlo per visualizzare le descrizioni di tutte le funzioni disponibili nel file <driver>.prm. La sezione Functions contiene i seguenti elementi subordinati: • Group: indica se l'uso di questa funzione in una query genera una clausola group by. Functions • True indica che la query genera una clausola group by. • False indica che la query non genera una clausola group by. • ID: si tratta del nome visualizzato nell'elenco delle funzioni "Oggetti utente" in Desktop Intelligence. Dichiarato obsoleto in questa versione. • InMacro: se questo valore è True, la funzione viene elencata nell'elenco delle funzioni "Oggetti utente" in Desktop Intelligence. Dichiarato obsoleto in questa versione. • Type: tipo dati della funzione. • Arguments: argomenti accettati dalla funzione. Una funzione può avere al massimo quattro argomenti ed eventuali altri argomenti non vengono presi in considerazione. • SQL: sintassi SQL per la funzione. Argomenti correlati • Visualizzazione e modifica di un file di testo della guida alle funzioni 12.3 Visualizzazione e modifica dei file PRM 1. Individuare la directory contenente il file PRM del driver di accesso ai dati di destinazione. I file PRM sono archiviati nelle directory dir-installazione-connectionserver\connectio nServer\<RDBMS>. 2. Aprire un file <driver>.prm in un editor XML. 219 2013-07-02 Configurazione dei parametri delle funzionalità dei database 3. Espandere le sezioni come necessario. 4. Impostare i valori immettendo il valore nel tag appropriato. 5. Salvare e chiudere il file. 12.4 Visualizzazione e modifica di un file di testo della guida alle funzioni Il testo della guida visualizzato per ogni funzione selezionata nello strumento di progettazione degli universi o nello strumento di progettazione delle informazioni è contenuto in un file XML separato. È possibile modificare e aggiungere testo descrittivo per una funzione modificando il file <driver><li ngua>.prm. Per ogni lingua dei prodotti SAP BusinessObjects installati è disponibile un file di testo della guida. Quando si aggiunge una funzione al file PRM, è necessario aggiungere il testo della guida per la nuova funzione al file <driver><lingua>.prm appropriato, ad esempio, se si aggiunge una funzione al file oracle.prm, si aggiunge anche il nome della funzione e il testo della guida per la funzione al file oracleen.prm se si utilizza la versione in inglese dello strumento. Vedere lo standard ISO639-1. 12.5 Modifica del testo della guida per una funzione PRM 1. Individuare la directory contenente il file di lingua PRM del driver di accesso ai dati di destinazione. I file PRM delle lingue sono archiviati nelle directory dir-installazione-connectionser ver\connectionServer\<RDBMS>. 2. Aprire un file <driver><lingua>.prm in un editor XML. 3. Espandere la sezione Messages. 4. Per aggiungere del testo guida per una nuova funzione, effettuare quanto segue: • Aggiungere una nuova sezione per una funzione. Il modo più semplice per eseguire questa operazione è copiare una funzione già esistente nella sezione Function. Quindi, modificare il testo della nuova funzione. • Immettere il testo guida per la funzione. 5. Per visualizzare o modificare del testo guida di una funzione esistente, effettuare quanto segue: • Espandere la sezione Function. • Espandere la sezione Message per una funzione. • Modificare il testo guida come necessario. 6. Salvare e chiudere il file. 220 2013-07-02 Riferimento ai parametri PRM Riferimento ai parametri PRM 13.1 Riferimento alla sezione Configuration dei file PRM I parametri delle funzionalità del database sono elencate in ordine alfabetico. Per visualizzare le funzioni, gli operatori di data e gli altri operatori disponibili, aprire un file <driver>.prm in un editor XML. Ogni parametro viene definito nel seguente tag: <Parameter Name="parametro">valore</Parameter> dove parameter è il nome del parametro e value è il valore attribuito al parametro. Ogni parametro viene visualizzato con le seguenti informazioni: • Esempio di visualizzazione del parametro nel file XML • Descrizione del parametro • Valori che è possibile impostare per il parametro • Valore predefinito per il parametro, se esiste Nota: alcuni parametri di configurazione non devono essere modificati. Tali parametri dispongono di valori impostati per essere utilizzati internamente nelle soluzioni SAP BusinessObjects. e vengono descritti nella presente sezione, ma contengono un messaggio che indica di non modificare il valore. Non modificare questi parametri. Prima di modificare i parametri del file PRM, è necessario creare una copia di backup del file PRM. 13.1.1 ANALYTIC_CLAUSE <Parameter Name="ANALYTIC_CLAUSE">WHEN</Parameter> Descrizione 221 Specifica la parola chiave SQL da utilizzare se una funzione specificata nel parametro ANALYTIC_FUNCTIONS viene utilizzata nell'istruzione SQL. 2013-07-02 Riferimento ai parametri PRM WHEN: indica che viene utilizzata una clausola WHEN. Si tratta del valore predefinito per i database IBM Red Brick. Valori QUALIFY: indica che viene utilizzata una clausola QUALIFY. Si tratta del valore predefinito per i database Teradata. Nota: Consultare la documentazione del database per informazioni sulle modalità di implementazione della clausola SQL. Predefinita Vedere i valori di cui sopra. Argomenti correlati • ANALYTIC_FUNCTIONS 13.1.2 ANALYTIC_FUNCTIONS <Parameter Name="ANALYTIC_FUNCTIONS">RANK,SUM,AVG,COUNT,MIN,MAX</Parameter> Descrizione Indica le funzioni analitiche supportate dal database. Valori Vedere i valori nei file PRM. Predefinita I valori indicati. 13.1.3 CALCULATION_FUNCTION <Parameter Name="CALCULATION_FUNCTION">YES</Parameter> Descrizione 222 Specifica se il database supporta le funzioni di calcolo. 2013-07-02 Riferimento ai parametri PRM Valori YES: il database supporta le funzioni di calcolo. In questo caso, Information Design Tool è in grado di creare colonne di calcolo. NO: il database non supporta le funzioni di calcolo. 13.1.4 CONSTANT_SAMPLING_SUPPORTED <Parameter Name="CONSTANT_SAMPLING_SUPPORTED">YES</Parameter> Descrizione Specifica se il database supporta il campionamento casuale. Il campionamento casuale consiste nell'estrarre a caso delle righe da un insieme di dati. YES: il database supporta il campionamento casuale. Valori NO: il database non supporta il campionamento casuale. Predefinita YES 13.1.5 DISTINCT <Parameter Name="DISTINCT">YES</Parameter> Descrizione 223 Specifica se il database supporta la parola chiave DISTINCT nelle istruzioni SQL. Questo parametro viene utilizzato con MS Access. 2013-07-02 Riferimento ai parametri PRM YES: il database supporta la parola chiave DISTINCT. Valori NO: il database non supporta la parola chiave DISTINCT. Questo comportamento causa la disabilitazione delle funzionalità seguenti: • l'opzione Valori distinti, visualizzata quando si fa clic sul pulsante Valori nella procedura guidata Creazione rapida degli universi di Universe Design Tool • Predefinita la funzione ConteggioDistinto, visualizzata al momento della creazione di una condizione con l'operando Calcolo nel Pannello delle query. YES 13.1.6 EXT_JOIN <Parameter Name="EXT_JOIN">YES</Parameter> Descrizione Specifica se il database supporta i join esterni. Viene utilizzato con tutti i driver di accesso ai dati. YES: il database supporta i join esterni. Valori NO: il database non supporta i join esterni. Le caselle di controllo Join esterno della finestra di dialogo Modifica join dello strumento di progettazione degli universi non sono disponibili. Predefinita YES 13.1.7 FULL_EXT_JOIN <Parameter Name="FULL_EXT_JOIN">YES</Parameter> 224 2013-07-02 Riferimento ai parametri PRM Descrizione Specifica se il database supporta tutti i join esterni. YES: il database supporta tutti i join esterni. Valori NO: il database non supporta tutti i join esterni. Predefinita YES 13.1.8 GROUP_BY <Parameter Name="GROUP_BY">NO</Parameter> Descrizione Specifica se il database supporta la clausola GROUP BY nelle istruzioni SQL. YES: il database supporta la clausola GROUP BY. Valori NO: il database non supporta la clausola GROUP BY. 13.1.9 GROUP_BY_SUPPORTS_COLUMN_INDEX <Parameter Name="GROUP_BY_SUPPORTS_COLUMN_INDEX">NO</Parameter> Descrizione Specifica se il database supporta l'utilizzo nella clausola GROUP BY degli indici di colonna estratti dall'istruzione SELECT. YES: il database supporta l'utilizzo degli indici di colonna dell'istruzione SELECT in sostituzione dei nomi di colonna. Valori NO: il database non supporta l'utilizzo degli indici di colonna dell'istruzione SELECT in sostituzione dei nomi di colonna. Predefinita 225 NO 2013-07-02 Riferimento ai parametri PRM 13.1.10 GROUP_BY_SUPPORTS_COMPLEX Parameter Name="GROUP_BY_SUPPORTS_COMPLEX">NO</Parameter> Specifica se il database supporta le espressioni complesse nella clausola GROUP BY. Le espressioni complesse sono tutti gli elementi diversi dai nomi di colonna o dagli indici presenti nell'istruzione SELECT, ad esempio le funzioni o le colonne assenti dall'istruzione SELECT. Questo parametro viene utilizzato con IBM DB2. Descrizione Nota: se si esegue una query contenente oggetti indicatore e oggetti complessi, ovvero oggetti che utilizzano funzioni e la concatenazione, nell'applicazione viene visualizzato il seguente messaggio di errore: Il database non consente di creare aggregazioni con l'oggetto <nome oggetto> . YES: il database supporta le espressioni complesse nella clausola GROUP BY. Valori NO: il database non supporta le espressioni complesse nella clausola GROUP BY. Predefinita NO 13.1.11 GROUP_BY_SUPPORTS_CONSTANT <Parameter Name="GROUP_BY_SUPPORTS_CONSTANT">YES</Parameter> Descrizione 226 Specifica se il database supporta l'utilizzo di oggetti costanti nella clausola GROUP BY. Questo parametro viene utilizzato nei database IBM DB2 e Microsoft SQL Server. 2013-07-02 Riferimento ai parametri PRM YES: il database supporta l'utilizzo di oggetti costanti nella clausola GROUP BY. Valori NO: il database non supporta l'utilizzo di oggetti costanti nella clausola GROUP BY. Predefinita YES 13.1.12 HAVING <Parameter Name="HAVING">NO</Parameter> Descrizione Specifica se il database supporta la clausola HAVING nelle istruzioni SQL. YES: il database supporta la clausola HAVING. Valori NO: il database non supporta la clausola HAVING. Predefinita NO 13.1.13 INTERSECT <Parameter Name="INTERSECT">INTERSECT</Parameter> Descrizione Specifica la parola chiave supportata dal database per l'operazione sugli insiemi INTERSECT. INTERSECT: la parola chiave supportata dal database è INTERSECT. Valori 227 Nessun valore: il database non supporta parole chiave per l'operazione sugli insiemi INTERSECT. In questo caso, vengono generate due query. 2013-07-02 Riferimento ai parametri PRM Predefinita INTERSECT 13.1.14 INTERSECT_ALL <Parameter Name="INTERSECT_ALL">YES</Parameter> Descrizione Specifica se il database supporta l'operazione sugli insiemi INTERSECT ALL. YES: il database supporta l'operazione sugli insiemi INTERSECT ALL. Valori NO: il database non supporta l'operazione sugli insiemi INTERSECT ALL. Predefinita YES 13.1.15 INTERSECT_IN_SUBQUERY <Parameter Name="INTERSECT_IN_SUBQUERY">YES</Parameter> Descrizione Specifica se il database supporta l'operazione sugli insiemi INTERSECT nelle sottoquery. YES: il database supporta l'operazione sugli insiemi INTERSECT nelle sottoquery. Valori NO: il database non supporta l'operazione sugli insiemi INTERSECT nelle sottoquery. 228 2013-07-02 Riferimento ai parametri PRM 13.1.16 JOIN <Parameter Name="JOIN">YES</Parameter> Descrizione Specifica se il database supporta un'operazione JOIN fra due tabelle. YES: il database supporta join fra qualsiasi colonna di due tabelle. Valori STRUCTURE_JOIN: il database supporta join fra due tabelle correlate a limiti referenziali. In questa versione è identico a NO. NO: il database non supporta join fra due tabelle. 13.1.17 LEFT_EXT_JOIN <Parameter Name="LEFT_EXT_JOIN">YES</Parameter> Descrizione Specifica se il database supporta join esterni a sinistra. YES: il database supporta join esterni a sinistra. Valori NO: il database non supporta join esterni a sinistra. 13.1.18 LEFT_OUTER <Parameter Name="LEFT_OUTER">$(+)</Parameter> <Parameter Name="LEFT_OUTER">$*</Parameter> Descrizione 229 Specifica la sintassi da utilizzare per le espressioni di join esterni a sinistra. 2013-07-02 Riferimento ai parametri PRM $(+): questa sintassi viene utilizzata con Oracle. Valori $*: questa sintassi viene utilizzata con Sybase, MS SQL Server e IBM Red Brick. Nota: $ rappresenta un'espressione di join. Predefinita Vedere i valori di cui sopra. Esempio Se table1.col1 è collegato a table2.col2 in Oracle, l'espressione generata è : table1.col1(+) = table2.col2. 13.1.19 LIKE_SUPPORTS_ESCAPE_CLAUSE <Parameter Name="LIKE_SUPPORTS_ESCAPE_CLAUSE">YES</Parameter> Descrizione Indica se il database supporta l'utilizzo di una clausola ESCAPE all'interno della condizione LIKE dell'istruzione SQL. YES: il database supporta la clausola ESCAPE nella condizione LIKE. Valori NO: il database non supporta la clausola ESCAPE nella condizione LIKE. Predefinito Se non si specifica questa impostazione, Connection Server recupera le informazioni dal middleware del database. 13.1.20 MINUS <Parameter Name="MINUS">MINUS</Parameter> Descrizione 230 Specifica la parola chiave supportata dal database per l'operazione sugli insiemi MINUS. 2013-07-02 Riferimento ai parametri PRM MINUS: il database supporta l'operatore MINUS. Valori EXCEPT: il database supporta l'operatore EXCEPT. Nessun valore: il database non supporta parole chiave per l'operazione sugli insiemi MINUS. In questo caso, vengono generate due query. Predefinita MINUS 13.1.21 MINUS_ALL <Parameter Name="MINUS_ALL">Yes</Parameter> Descrizione Specifica se il database supporta l'operazione sugli insiemi MINUS ALL. YES: il database supporta l'operazione sugli insiemi MINUS ALL. Valori NO: il database non supporta l'operazione sugli insiemi MINUS ALL. 13.1.22 MINUS_IN_SUBQUERY <Parameter Name="MINUS_IN_SUBQUERY ">YES</Parameter> Descrizione Specifica se il database supporta l'operazione sugli insiemi MINUS nelle sottoquery. YES: il database supporta l'operazione sugli insiemi MINUS nelle sottoquery. Valori NO: il database non supporta l'operazione sugli insiemi MINUS nelle sottoquery. 231 2013-07-02 Riferimento ai parametri PRM 13.1.23 ORDER_BY <Parameter Name="ORDER_BY">YES</Parameter> Descrizione Specifica se il database supporta la clausola ORDER BY. YES: il database supporta la clausola ORDER BY. Valori NO: il database non supporta la clausola ORDER BY. 13.1.24 ORDER_BY_REQUIRES_SELECT <Parameter Name="ORDER_BY_REQUIRES_SELECT">NO</Parameter> Descrizione Valori Specifica se il database richiede che si faccia riferimento alle colonne utilizzate nella clausola ORDER BY nell'istruzione SELECT. YES: gli utenti non sono autorizzati a ordinare le colonne se non sono incluse nell'istruzione SELECT. In questo caso, il pulsante Gestione ordinamenti non è disponibile nel pannello delle query dello strumento di progettazione degli universi. NO: gli utenti sono autorizzati a ordinare le colonne anche se non sono incluse nell'istruzione SELECT. Predefinita NO 13.1.25 ORDER_BY_SUPPORTS_COLUMN_INDEX <Parameter Name="ORDER_BY_SUPPORTS_COLUMN_INDEX">YES</Parameter> 232 2013-07-02 Riferimento ai parametri PRM Descrizione Specifica se il database supporta l'utilizzo degli indici di colonna dall'istruzione SELECT nella clausola ORDER BY. YES: il database supporta l'utilizzo degli indici di colonna dell'istruzione SELECT in sostituzione dei nomi di colonna. Valori NO: il database non supporta l'utilizzo degli indici di colonna dell'istruzione SELECT in sostituzione dei nomi di colonna. 13.1.26 PERCENT_RANK_SUPPORTED <Parameter Name="PERCENT_RANK_SUPPORTED">YES</Parameter> Descrizione Specifica se il database supporta la funzione analitica di rango percentuale. Consultare la documentazione del database per le istruzioni sull'implementazione del rango percentuale. YES: il database supporta il rango percentuale. Valori NO: il database non supporta il rango percentuale. Predefinita YES 13.1.27 RANK_SUPPORTED <Parameter Name="RANK_SUPPORTED">YES</Parameter> Descrizione Specifica se il database supporta la funzione analitica di rango nelle istruzioni SQL. YES: il database supporta il rango. Valori NO: il database non supporta il rango. 233 2013-07-02 Riferimento ai parametri PRM Predefinita YES 13.1.28 RIGHT_EXT_JOIN <Parameter Name="RIGHT_EXT_JOIN">YES</Parameter> Descrizione Specifica se il database supporta join esterni a destra. YES: il database supporta join esterni a destra. Valori NO: il database non supporta join esterni a destra. 13.1.29 RIGHT_OUTER <Parameter Name="RIGHT_OUTER">$(+)</Parameter> <Parameter Name="RIGHT_OUTER">*$</Parameter> Descrizione Specifica la sintassi da utilizzare per le espressioni di join esterni a destra. $(+): questa sintassi viene utilizzata con Oracle. Valori *$: questa sintassi viene utilizzata con Sybase, MS SQL Server e IBM Red Brick. Nota: $ rappresenta un'espressione di join. Predefinita 234 Vedere i valori di cui sopra. 2013-07-02 Riferimento ai parametri PRM 13.1.30 SEED_SAMPLING_SUPPORTED <Parameter Name="SEED_SAMPLING_SUPPORTED">YES</Parameter> Descrizione Specifica se il database supporta il campionamento seed. Il campionamento seed è una variazione del campionamento casuale in cui il valore iniziale casuale viene fornito dall'utente. YES: il database supporta il campionamento seed. Valori NO: il database non supporta il campionamento seed. Predefinita NO 13.1.31 SELECT_SUPPORTS_NULL <Parameter Name="NULL_IN_SELECT_SUPPORTED">YES</Parameter> Descrizione Specifica se il database supporta NULL come colonna nell'istruzione SELECT. YES: il database supporta NULL come colonna nell'istruzione SELECT. Valori NO: il database non supporta NULL come colonna nell'istruzione SELECT. YES Predefinita 235 NO per i database Teradata, IBM DB2, IBM Informix e IBM Red Brick, che non supportano il valore NULL come colonna. 2013-07-02 Riferimento ai parametri PRM 13.1.32 SUBQUERY_IN_FROM <Parameter Name="SUBQUERY_IN_FROM">YES</Parameter> Descrizione Specifica se il database supporta l'utilizzo di sottoquery all'interno della clausola FROM. YES: il database supporta l'utilizzo di sottoquery all'interno della clausola FROM. Valori NO: il database non supporta l'utilizzo di sottoquery all'interno della clausola FROM. 13.1.33 SUBQUERY_IN_IN <Parameter Name="SUBQUERY_IN_IN">YES</Parameter> Descrizione Specifica se il database supporta l'utilizzo di sottoquery all'interno della clausola IN. YES: il database supporta l'utilizzo di sottoquery all'interno della clausola IN. Valori NO: il database non supporta l'utilizzo di sottoquery all'interno della clausola IN. 13.1.34 SUBQUERY_IN_WHERE <Parameter Name="SUBQUERY_IN_WHERE">YES</Parameter> 236 2013-07-02 Riferimento ai parametri PRM Descrizione Specifica se il database supporta l'utilizzo di sottoquery all'interno della clausola WHERE. YES: il database supporta l'utilizzo di sottoquery all'interno della clausola WHERE. Valori NO: il database non supporta l'utilizzo di sottoquery all'interno della clausola WHERE. 13.1.35 TECHNICAL_COLUMN_NAME_PATTERN <Parameter Name="TECHNICAL_COLUMN_NAME_PATTERN">^(-idref)(.)*</Parameter> Descrizione Specifica che tutte le colonne che iniziano con il motivo -idref non vengono visualizzate nelle connessioni, nelle basi dati e nei livelli aziendali di universi basati su origini dati OData. Information Designer non potrà pertanto creare query con queste colonne. Nota: Non modificare questo parametro. Valore ^(-idref)(.)* 13.1.36 UNION <Parameter Name="UNION">UNION</Parameter> Descrizione 237 Specifica la parola chiave supportata dal database per l'operazione sugli insiemi UNION. 2013-07-02 Riferimento ai parametri PRM UNION: la parola chiave supportata dal database è UNION. Valori Nessun valore: il database non supporta parole chiave per l'operazione sugli insiemi UNION. In questo caso, vengono generate due query. Predefinita UNION 13.1.37 UNION_ALL <Parameter Name="UNION_ALL">YES</Parameter> Descrizione Specifica se il database supporta l'operazione sugli insiemi UNION ALL. YES: il database supporta l'operazione sugli insiemi UNION ALL. Valori NO: il database non supporta l'operazione sugli insiemi UNION ALL. 13.1.38 UNION_IN_SUBQUERY <Parameter Name="UNION_IN_SUBQUERY">YES</Parameter> Descrizione Specifica se il database supporta l'utilizzo dell'operazione sugli insiemi UNION nelle sottoquery. YES: il database supporta l'operazione sugli insiemi UNION nelle sottoquery. Valori NO: il database non supporta l'operazione sugli insiemi UNION nelle sottoquery. 238 2013-07-02 Riferimento per la conversione dei tipi di dati Riferimento per la conversione dei tipi di dati 14.1 Conversione dei tipi di dati In Information Design Tool, le basi dati espongono tabelle da uno o più database relazionali, che costituiscono le basi dei livelli aziendali. Il tipo di dati associato a ogni colonna di tabella viene visualizzato in una base dati con altri dettagli di colonna. I livelli aziendali espongono le colonne di tabella come oggetti metadati, quali dimensioni e gerarchie, e visualizzano il tipo di dati associato a ogni oggetto. Nella tabella seguente viene descritta la mappatura tra questi due insiemi di tipi di dati: Tipo di dati visualizzato nella base dati Tipo di dati visualizzato nel livello aziendale BINARY, LONGVARBINARY, VARBINARY BLOB BIT Booleano DATA Data TIME, TIMESTAMP DateTime LONGVARCHAR Testo lungo BIGINT, DECIMAL, DOUBLE, FLOAT, INTEGER, NUMERIC, REAL, SMALLINT, TINYINT Numerico CHAR, VARCHAR, XML Stringa UNDEFINED Sconosciuto Nota: Da qualsiasi database, l'ora viene gestita come DateTime nella piattaforma BI. La parte relativa alla data di DateTime normalmente deve essere visualizzata come la data corrente nei report degli utenti finali. 239 2013-07-02 Riferimento per la conversione dei tipi di dati Il livello di accesso ai dati gestisce la conversione dei tipi di dati esposti dai livelli aziendali nei tipi di dati di Connection Server, che vengono quindi mappati ai tipi di dati esposti nelle basi dati. In questa sezione vengono fornite le tabella di conversione tra i tipi di dati del livello di rete generico (JDBC e ODBC) e i tipi di dati della base dati. Vengono inoltre fornite le tabelle di conversione per livelli di rete specifici, ad esempio OLE DB, Oracle OCI e Sybase CTL, oltre alla descrizione delle conversioni importanti e delle eccezioni per database specifici, come i file CSV e i sistemi SAP ERP. Argomenti correlati • ABAP • File CSV • JDBC • ODBC • OData • OLE DB • Oracle OCI • Sybase CTL • XML e servizi Web 14.1.1 ABAP Nella tabella seguente sono elencati i tipi di dati ABAP utilizzati dai sistemi SAP ERP e i rispettivi equivalenti nelle basi dati. 240 Tipo di dati ABAP Tipo di dati della base dati HEXADECIMAL BINARY DATA DATA ORA ORA FLOAT FLOAT INTEGER INTEGER NUMERIC TEXT, PACKED NUMBER NUMERIC 2013-07-02 Riferimento per la conversione dei tipi di dati Tipo di dati ABAP Tipo di dati della base dati TEXT CHAR VARIABLE LENGTH STRING VARCHAR 14.1.2 File CSV Nella tabella seguente sono elencati i tipi di dati dichiarati nei file DDL per il rilevamento dello schema dei file CSV e il rispettivo equivalente nelle basi dati. Tipo dichiarato nel file DDL Tipo di dati della base dati BIT, BOOLEAN BIT DATA DATA ORA ORA TIMESTAMP TIMESTAMP BIGINT, DECIMAL DECIMAL FLOAT, DOUBLE, REAL DOUBLE INTEGER, INT, SMALLINT INTEGER NUMBER, NUMERIC NUMERIC VARCHAR VARCHAR Argomenti correlati • Rilevamento dello schema CSV 241 2013-07-02 Riferimento per la conversione dei tipi di dati 14.1.3 JDBC Nella tabella seguente sono elencati i tipi di dati che vengono visualizzati tramite JDBC e gli equivalenti nelle basi dati. 242 Tipo di dati JDBC Tipo di dati della base dati BINARY BINARY VARBINARY VARBINARY BLOB, LONGVARBINARY LONGVARBINARY BIT, BOOLEAN BIT CLOB, NCLOB LONGVARCHAR DATA DATA ORA ORA TIMESTAMP TIMESTAMP DOUBLE DOUBLE FLOAT FLOAT REAL REAL SMALLINT SMALLINT CHAR, NCHAR CHAR LONGNVARCHAR, LONGVARCHAR, NVARCHAR, ROWID, VARCHAR VARCHAR 2013-07-02 Riferimento per la conversione dei tipi di dati Tipo di dati JDBC Tipo di dati della base dati SQLXML XML IBM Informix Nella tabella seguente vengono elencati i tipi di dati che possono essere visualizzati nei risultati delle query utente in un database IBM Informix tramite JDBC e i relativi equivalenti nelle basi dati. Questi tipi di dati sovrascrivono quelli generici. Tipo di dati Informix JDBC Tipo di dati della base dati TIMESTAMP Può essere mappato al seguente tipo: • DATE se il tipo di dati Informix segue il motivo DATETIME\\s+(HOUR|MINUTE|SECO ND)\\s+TO\\s+(HOUR|MINUTE|SECOND) • TIME se il tipo di dati Informix segue il motivo DATETIME\\s+(YEAR|MO NTH|DAY)\\s+TO\\s+(YEAR|MONTH|DAY) • TIMESTAMP negli altri casi BOOLEAN SMALLINT MS SQL Server Nella tabella seguente vengono elencati i tipi di dati che possono essere visualizzati nei risultati delle query utente in un database MS SQL Server tramite JDBC e i relativi equivalenti nelle basi dati. La mappatura del tipo di dati dipende anche dal nome del tipo SQL associato al tipo di dati del livello di rete. Questi tipi di dati sovrascrivono quelli generici. Tipo di dati JDBC in MS SQL Server Nome del tipo SQL Tipo di dati della base dati LONGVARCHAR Qualsiasi valore diverso da "xml" VARCHAR LONGVARCHAR xml XML Oracle Nella tabella seguente vengono elencati i tipi di dati che possono essere visualizzati nei risultati delle query utente in un database Oracle tramite JDBC e i relativi equivalenti nelle basi dati. La mappatura 243 2013-07-02 Riferimento per la conversione dei tipi di dati del tipo di dati dipende anche dal nome del tipo SQL associato al tipo di dati del livello di rete. Questi tipi di dati sovrascrivono quelli generici. Tipo di dati Oracle JDBC Nome del tipo SQL Tipo di dati della base dati BFILE qualsiasi valore LONGVARBINARY qualsiasi valore BFILE LONGVARBINARY DATA qualsiasi valore TIMESTAMP qualsiasi valore TIMESTAMP TIMESTAMP BINARY_DOUBLE qualsiasi valore DOUBLE OTHER FLOAT DOUBLE BINARY_FLOAT qualsiasi valore REAL qualsiasi valore NCHAR CHAR qualsiasi valore NVARCHAR2, ROWID, UROWID VARCHAR 14.1.4 ODBC Nella tabella seguente sono elencati i tipi di dati che vengono visualizzati tramite ODBC e gli equivalenti nelle basi dati. 244 Tipo di dati ODBC Tipo di dati della base dati SQL_BINARY BINARY SQL_VARBINARY VARBINARY 2013-07-02 Riferimento per la conversione dei tipi di dati 245 Tipo di dati ODBC Tipo di dati della base dati SQL_LONGVARBINARY LONGVARBINARY SQL_BIT BIT SQL_DATE, SQL_TYPE_DATE DATA SQL_DATETIME, SQL_TIME, SQL_TIMESTAMP, SQL_TYPE_TIME, SQL_TYPE_TIMESTAMP TIMESTAMP SQL_LONGVARCHAR, SQL_WLONGVARCHAR LONGVARCHAR SQL_BIGINT BIGINT SQL_DECIMAL DECIMAL SQL_DOUBLE DOUBLE SQL_FLOAT FLOAT SQL_INTEGER INTEGER SQL_NUMERIC NUMERIC SQL_REAL REAL SQL_SMALLINT SMALLINT SQL_TINYINT TINYINT SQL_CHAR, SQL_GUID, SQL_WCHAR CHAR SQL_VARCHAR, SQL_WVARCHAR VARCHAR 2013-07-02 Riferimento per la conversione dei tipi di dati IBM DB2 Nella tabella seguente vengono elencati i tipi di dati che possono essere visualizzati nei risultati delle query utente in un database IBM DB2 tramite ODBC e i relativi equivalenti nelle basi dati. Questi tipi di dati sovrascrivono quelli generici. Tipo di dati ODBC DB2 Tipo di dati della base dati SQL_BLOB LONGVARBINARY SQL_CLOB, SQL_DBCLOB, SQL_LONGVARGRAPHIC LONGVARCHAR SQL_DECFLOAT DOUBLE SQL_GRAPHIC CHAR SQL_VARGRAPHIC VARCHAR SQL_XML XML IBM Informix Nella tabella seguente vengono elencati i tipi di dati che possono essere visualizzati nei risultati delle query utente in un database IBM Informix tramite ODBC e i relativi equivalenti nelle basi dati. Questi tipi di dati sovrascrivono quelli generici. 246 Tipo di dati ODBC Informix Tipo di dati della base dati SQL_BIT SMALLINT SQL_INFX_UDT_BLOB LONGVARBINARY SQL_TIMESTAMP, SQL_TYPE_TIMESTAMP Può essere mappato al seguente tipo: • DATE se il tipo di dati Informix segue il motivo DATETIME\\s+(HOUR|MINUTE|SECO ND)\\s+TO\\s+(HOUR|MINUTE|SECOND) • TIME se il tipo di dati Informix segue il motivo DATETIME\\s+(YEAR|MO NTH|DAY)\\s+TO\\s+(YEAR|MONTH|DAY) • TIMESTAMP negli altri casi 2013-07-02 Riferimento per la conversione dei tipi di dati Tipo di dati ODBC Informix Tipo di dati della base dati SQL_INFX_UDT_CLOB LONGVARCHAR MS SQL Server Nella tabella seguente vengono elencati i tipi di dati che possono essere visualizzati nei risultati delle query utente in un database MS SQL Server tramite ODBC e i relativi equivalenti nelle basi dati. Questi tipi di dati sovrascrivono quelli generici. Tipo di dati ODBC in MS SQL Server Tipo di dati della base dati SQL_SS_TIME2, SQL_SS_TIMESTAMPOFFSET TIMESTAMP SQL_SS_XML XML 14.1.5 OData La seguente tabella elenca i tipi di dati Entity Data Model (EDM) interni alle origini dati OData e i tipi equivalenti nelle basi dati. Tipo i dati OData Tipo di dati della base dati Edm.Binary BINARY Edm.Boolean BIT TIMESTAMP 247 Edm.DateTime, Edm.Time Nota: I nanosecondi non vengono mappati. Edm.Int64 BIGINT Edm.Decimal DECIMAL 2013-07-02 Riferimento per la conversione dei tipi di dati Tipo i dati OData Tipo di dati della base dati Edm.Double DOUBLE Edm.Float, Edm.Single FLOAT Edm.Int32 INTEGER Edm.Byte, Edm.Int16, Edm.SByte SMALLINT Edm.DateTimeOffset, Edm.Guid, Edm.String VARCHAR 14.1.6 OLE DB Nella tabella seguente sono elencati i tipi di dati che vengono visualizzati tramite OLE DB e gli equivalenti nelle basi dati. Nota: Per alcuni tipi di dati, la mappatura dipende dai valori dei parametri DBCOLUMNFLAGS_ISLONG e DBCO LUMNFLAGS_ISFIXEDLENGTH associati a ogni tipo. 248 Tipo di dati OLE DB Tipo di dati della base dati DBTYPE_BYTES VARBINARY DBTYPE_BYTES if DBCOLUMNFLAGS_ISLONG=true LONGVARBINARY DBTYPE_BYTES if DBCOLUMNFLAGS_ISFIXEDLE NGTH=true BINARY DBTYPE_BOOL BIT DBTYPE_DBDATE DATA 2013-07-02 Riferimento per la conversione dei tipi di dati Tipo di dati OLE DB Tipo di dati della base dati DBTYPE_DBTIME ORA DBTYPE_DBTIMESTAMP TIMESTAMP DBTYPE_DECIMAL DECIMAL DBTYPE_I1, DBTYPE_UI1 TINYINT DBTYPE_I2, DBTYPE_UI2 SMALLINT DBTYPE_I4, DBTYPE_UI4 INTEGER DBTYPE_I8, DBTYPE_UI8 BIGINT DBTYPE_R4 REAL DBTYPE_R8 DOUBLE DBTYPE_CY, DBTYPE_NUMERIC NUMERIC DBTYPE_STR, DBTYPE_WSTR VARCHAR DBTYPE_STR, DBTYPE_WSTR if DBCOLUMN FLAGS_ISLONG=true LONGVARCHAR DBTYPE_STR, DBTYPE_WSTR if DBCOLUMN FLAGS_ISFIXEDLENGTH=true CHAR Tipi di dati MS SQL Server Nella tabella seguente vengono elencati i tipi di dati che possono essere visualizzati nei risultati delle query utente in un database MS SQL Server tramite OLE DB e i relativi equivalenti nelle basi dati. Questi tipi di dati sovrascrivono quelli precedenti. 249 2013-07-02 Riferimento per la conversione dei tipi di dati Tipo di dati OLE DB in MS SQL Server Tipo di dati della base dati DBTYPE_DBTIME2, DBTYPE_DBTIMESTAMPOFFSET TIMESTAMP DBTYPE_GUID CHAR DBTYPE_XML XML 14.1.7 Oracle OCI Nella tabella seguente sono elencati i tipi di dati che vengono visualizzati tramite Oracle OCI e gli equivalenti nelle basi dati. 250 Tipo di dati Oracle OCI Tipo di dati della base dati SQLT_BIN BINARY SQLT_BFILE, SQLT_BLOB, SQLT_LBI LONGVARBINARY SQLT_DAT, SQLT_DATE, SQLT_TIME, SQLT_TIMESTAMP, SQLT_TIMESTAMP_LTZ, SQLT_TIMESTAMP_TZ TIMESTAMP SQLT_CLOB, SQLT_LNG LONGVARCHAR SQLT_FLT, SQLT_IBDOUBLE DOUBLE SQLT_IBFLOAT REAL SQLT_NUM NUMERIC SQLT_AFC CHAR 2013-07-02 Riferimento per la conversione dei tipi di dati Tipo di dati Oracle OCI Tipo di dati della base dati SQLT_CHR, SQLT_RDD, SQLT_RID VARCHAR 14.1.8 Sybase CTL Nella tabella seguente sono elencati i tipi di dati che vengono visualizzati tramite Sybase CTL e gli equivalenti nelle basi dati. Nota: i tipi di dati Sybase CTL sono valori del campo datatype della struttura CS_DATAFMT, che viene esposto dal livello di rete. Per alcuni tipi di dati viene anche fornito il valore del campo usertype della struttura, che viene utilizzato per la mappatura dal livello di accesso ai dati. 251 Tipo di dati Sybase CTL usertype Sybase CTL Tipo di dati della base dati CS_BINARY_TYPE CS_BINARY_USERTYPE BINARY CS_BINARY_TYPE CS_VARBINARY_USERTYPE o nessun valore VARBINARY CS_LONGBINARY_TYPE Qualsiasi valore VARBINARY CS_IMAGE_TYPE Qualsiasi valore LONGVARBINARY CS_BIT_TYPE Qualsiasi valore BIT CS_DATE_TYPE Qualsiasi valore DATA CS_BIGDATETIME_TYPE, CS_BIGTIME_TYPE, CS_DATETIME_TYPE, CS_DATETIME4_TYPE, CS_TIME_TYPE Qualsiasi valore TIMESTAMP CS_LONGCHAR_TYPE, CS_TEXT_TYPE Qualsiasi valore LONGVARCHAR 2013-07-02 Riferimento per la conversione dei tipi di dati 252 Tipo di dati Sybase CTL usertype Sybase CTL Tipo di dati della base dati CS_BIGINT_TYPE, CS_UBIGINT_TYPE Qualsiasi valore BIGINT CS_DECIMAL_TYPE, CS_MONEY_TYPE, CS_MONEY4_TYPE Qualsiasi valore DECIMAL CS_FLOAT_TYPE Qualsiasi valore DOUBLE CS_INT_TYPE, CS_UINT_TYPE Qualsiasi valore INTEGER CS_NUMERIC_TYPE Qualsiasi valore NUMERIC CS_REAL_TYPE Qualsiasi valore REAL CS_SMALLINT_TYPE, CS_USMALLINT_TYPE Qualsiasi valore SMALLINT CS_TINYINT_TYPE Qualsiasi valore TINYINT CS_CHAR_TYPE CS_CHAR_USERTYPE, CS_NCHAR_USERTYPE o CS_UNICHAR_USERTYPE CHAR CS_CHAR_TYPE CS_VARCHAR_USERTYPE, CS_NVARCHAR_USERTYPE, CS_UNIVARCHAR_USERTYPE, CS_SYSNAME_USERTYPE o nessun valore VARCHAR CS_UNICHAR_TYPE USER_UNICHAR_TYPE CHAR CS_UNICHAR_TYPE USER_UNIVARCHAR_TYPE o nessun valore VARCHAR 2013-07-02 Riferimento per la conversione dei tipi di dati 14.1.9 XML e servizi Web La seguente tabella elenca i tipi di dati incorporati XML e i tipi equivalenti nelle basi dati. 253 Tipo di dati incorporato XML Tipo di dati della base dati boolean BIT base64Binary, hexBinary • • data DATA time ORA dateTime TIMESTAMP float FLOAT double, decimal DOUBLE integer, negativeInteger, nonPositiveInteger, noNegativeInteger, positiveInteger DECIMAL long, unsignedLong BIGINT int, unsignedInt INTEGER short, unsignedShort SMALLINT byte, unsignedByte TINYINT BINARY, se è definita una lunghezza VARBINARY 2013-07-02 Riferimento per la conversione dei tipi di dati Tipo di dati incorporato XML Tipo di dati della base dati • • string anySimpleType, anyType, anyURI, duration, gDay, gMonth, gMonthDay, gYear, gYearMonth, NOTATION, QName CHAR, se è definita una lunghezza VARCHAR Nota: I tipi di dati derivati da string vengono mappati a CHAR o VARCHAR. VARCHAR Mappatura dei metadati delle colonne • • • La presenza o meno del segno dipende dal tipo di dati. Il valore nullable dipende dagli attributi nullable e minOccurs. La dimensione delle colonne, le cifre decimali e la dimensione di visualizzazione dipendono dal tipo di dati. Se il tipo non fornisce alcuna indicazione, viene restituita una lunghezza configurabile dall'utente. 14.2 Restrizione dei dati a lunghezza variabile di grandi dimensioni Limitazione: quanto segue riguarda solo le applicazioni Crystal Reports. A causa dell'implementazione del livello di accesso ai dati, le dimensioni massime di una colonna per i dati binari e di caratteri a lunghezza variabile di grandi dimensioni sono limitate e 16 MB per le seguenti origini dati: • IBM DB2 tramite ODBC • MS SQL Server tramite ODBC • Sybase CTL Se l'utente di un'applicazione inserisce dati a lunghezza variabile di grandi dimensioni superiori a 16 MB in un report, le prestazioni del sistema possono subire delle conseguenze. 14.3 Mappatura dei tipi di dati per gli universi con più origini 254 2013-07-02 Riferimento per la conversione dei tipi di dati In caso di base dati abilitata per più origini, i tipi di dati di Connection Server vengono convertiti nei tipi di dati esposti tramite il servizio Data Federation. I tipi di dati Data Federation sono i seguenti: • • • • • • • • BIT DATA ORA TIMESTAMP DOUBLE DECIMAL INTEGER VARCHAR Tali tipi di dati vengono mappati ai corrispondenti tipi di dati di Data Federation. Avvertenza: i tipi BINARY, VARBINARY e LONGVARBINARY non sono supportati e i valori di questi tipi vengono mappati a NULL. 255 2013-07-02 Riferimento per la conversione dei tipi di dati 256 2013-07-02 Ulteriori informazioni Ulteriori informazioni Informazioni Posizione Informazioni sul prodotto SAP BusinessObjects http://www.sap.com Passare a http://help.sap.com/businessobjects/ e nel pannello laterale "SAP BusinessObjects Overview" fare clic su All Products. SAP Help Portal Nel portale della Guida in linea SAP è possibile accedere alla documentazione più aggiornata riguardante tutti i prodotti SAP BusinessObjects e la relativa distribuzione. È possibile scaricare le versioni PDF o le librerie HTML installabili. Alcuni manuali sono memorizzati nel SAP Service Marketplace e non sono disponibili nel SAP Help Portal. Questi manuali sono elencati nell'Help Portal accompagnati da un collegamento al SAP Service Marketplace. I clienti con contratto di manutenzione dispongono di un ID utente autorizzato per l'accesso a questo sito. Per ottenere un ID, contattare il rappresentante del supporto tecnico. http://service.sap.com/bosap-support > Documentazione • • SAP Service Marketplace Guide all'installazione: https://service.sap.com/bosap-instguides Note sulla versione: http://service.sap.com/releasenotes Nel SAP Service Marketplace sono memorizzati alcuni documenti dei seguenti tipi: guide all'installazione, manuali di aggiornamento e migrazione, manuali della distribuzione in rete, note sulla versione e documenti relativi alle piattaforme supportate. I clienti con contratto di manutenzione dispongono di un ID utente autorizzato per l'accesso a questo sito. Per ottenere un ID, contattare il rappresentante del supporto tecnico. Se si viene reindirizzati al SAP Service Marketplace dal SAP Help Portal, utilizzare il menu nel riquadro di spostamento sulla sinistra per individuare la categoria contenente la documentazione a cui si desidera accedere. https://cw.sdn.sap.com/cw/community/docupedia Docupedia 257 Docupedia fornisce ulteriori risorse di documentazione, un ambiente di creazione collaborativo e un canale di feedback interattivo. 2013-07-02 Ulteriori informazioni Informazioni Posizione https://boc.sdn.sap.com/ Risorse per lo sviluppatore https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary Articoli su SAP BusinessObjects relativi a SAP Community Network https://www.sdn.sap.com/irj/boc/businessobjects-articles Questi articoli erano conosciuti in precedenza come schede tecniche. https://service.sap.com/notes Note Queste note erano conosciute in precedenza come articoli di knowledge base. Forum su SAP Community Network https://www.sdn.sap.com/irj/scn/forums http://www.sap.com/services/education Formazione I pacchetti di formazione disponibili variano dal tradizionale apprendimento in classe ai seminari di e-learning mirati e sono in grado di soddisfare qualsiasi esigenza e stile di apprendimento. http://service.sap.com/bosap-support Supporto tecnico in linea SAP Support Portal contiene informazioni sui programmi e i servizi del supporto tecnico. Inoltre, contiene collegamenti a una vasta gamma di informazioni tecniche e download. I clienti con contratto di manutenzione dispongono di un ID utente autorizzato per l'accesso a questo sito. Per ottenere un ID, contattare il rappresentante del supporto tecnico. http://www.sap.com/services/bysubject/businessobjectsconsulting Consulenza 258 I consulenti sono a disposizione dei clienti dalla fase di analisi iniziale fino alla consegna del progetto di distribuzione. Possono essere fornite co nsulenze su argomenti quali i database relazionali e multidimensionali, la connettività, gli strumenti di progettazione del database e la tecnologia di incorporamento personalizzata. 2013-07-02 Indice A allocazione di memoria 42 analisi 152, 159 ANALYTIC_CLAUSE 221 ANALYTIC_FUNCTIONS 222 architettura 24 architettura di sistema 24 Array Bind Available 176 Array Bind Size 176 Array Fetch Available 177 attività del flusso di lavoro 43 attività principali 21 B BigDecimal Max Display Size 179 bilanciamento del carico 39 Binary Max Length 87, 107, 114, 179 Bucket Split Size 180 C CALCULATION_FUNCTION 222 Catalog Separator 180 CharSet 206 Charset List Extension 143 CharSet Table 181 ClassPath creazione di una connessione JavaBean 65 creazione di una connessione JDBC 58 CMC 143 colonne di input 90 compatibilità con le versioni precedenti 41, 71 Config File Extension 144 Connection Server analisi in modalità libreria 156 analisi in modalità server 157 attività del flusso di lavoro 43 configurazione dell'accesso ai dati per driver con marchio DataDirect 171 configurazione delle impostazioni globali 143 configurazione modalità di distribuzione 150 configurazione per connessioni ODBC a Data Federator 136 259 Connection Server (segue) configurazione per distribuzione complessa 150 definizione 23 definizione dei protocolli in modalità Server 151 informazioni sulle impostazioni globali 141 lettura di registri e analisi 157 memoria 42 modalità di distribuzione 28 scelta di una modalità di distribuzione 149 stored procedure 35 supporto a 64 bit 31 Connection Shareable 200 Connection Status Available 206 connessioni componenti di 23 configurazione delle connessioni JDBC 170 creazione di connessioni JavaBean con Extensions 66 creazione di connessioni JDBC con Extensions 59 creazione di connessioni JDBC con i file SBO 58 creazione di connessioni JDBC generiche 63 creazione di connessioni ODBC generiche 67 creazione di connessioni ODBC3 generiche 68 creazione di Data Federator XI 3.0 133 creazione di una connessione JavaBean 65 requisiti per la creazione 45 connessioni Amazon EMR HIVE 116 connessioni Apache Hadoop HIVE 115 connessioni Essbase 120 connessioni IBM DB2 117 connessioni IBM Informix 117 connessioni JavaBean creazione 65 creazione con Extensions 66 connessioni JDBC aggiunta delle proprietà del driver 170 connessioni OData 76, 86 analisi 88 connessioni OData (segue) funzionalità del driver 77 HTTPS 77 prestazioni 84 schema 78 tipi di dati 247 connessioni Oracle EBS 119 Connessioni Oracle JDBC 119 connessioni Oracle RAC 120 connessioni salesforce.com 120 connessioni SAP ERP 89, 199 tipi di dati 240 connessioni SAP HANA 122, 191 stored procedure 37 connessioni SAP MaxDB 128 connessioni SAP NetWeaver BW 129 connessioni SAS 130 connessioni SQL Server Analysis Services 118 connessioni Teradata 130 connessioni XML 95 connettività supportate 50 connettori SAP NetWeaver BW 129 SAS 130 CONSTANT_SAMPLING_SUPPORTED 223 convalida delle connessioni al runtime 169 convenzioni 21 conversione dei tipi di dati 239 Cost Estimate Available 207 Crystal Reports 254 cscheck accessdriver 53 assistenza per l’uso 46 connettività 54 driverssearch 49 elenco 48 elenco delle funzioni 47 esecuzione 47 middleware 52 ping 55 ricerca 50 sintassi 47 D Data Federator XI 3.0 directory di installazione 134 2013-07-02 Indice Data Federator XI 3.0 (segue) informazioni sulla creazione di connessioni 133 versione richiesta 133 database configurazione dell'accesso 150 elenco database supportati 48 parametri funzionalità 217 selezione accesso a 151 supporto di stored procedure 35 verifica accesso 55 database supportati 48 DataDirect 170 Description Extension 144 Description File 181 destinatari del manuale 19 Dictionary Transaction Mode 182 dimensioni array fetch 95, 177 DISTINCT 223 Driver Behavior 212 Driver Capabilities 182 driver con marchio 170 driver di accesso ai dati configurazione dei parametri 161 file CSV 71 file di configurazione 161 file PRM 217 file utilizzati da 26 informazioni su 24 ricerca di componenti installati 49 selezione 150 sistemi SAP ERP 89 verifica della disponibilità in un computer 53 driver di esempio 24 driver Java 57 Driver Name 183 Driver ODBC 33 DriverDefaults 141 E Empty String 207 Enforce Max Protocol Version 205 Enumerator CLSID 210 ERP Max Rows 95, 199 Escape Character 183 Escape Character Available 200 EXT_JOIN 224 Extensions 184 creazione di una connessione JavaBean 66 creazione di una connessione JDBC 59 260 F H failover 119, 122 Family 184 file _trace.ini 152 file cs.cfg 156 informazioni 26, 141 modifica 142 riferimento ai parametri Settings 143 sezione Capabilities 149 sezione Library 150 visualizzazione 142 file CSV 71 tipi di dati 241 File DDL 74 file di configurazione 161 file SBO installati 162 file specifici di un driver 26 global file 26 informazioni su 25 SBO JavaBean, esempio 65 file di registro 152, 159 file OlapClient.cfg 159 informazioni 142 file openrda.ini 135 file PRM informazioni 217 informazioni su testo della guida alle funzioni 220 modifica 219 modifica testo della guida 220 struttura 218 visualizzazione 219 File SQLDDL 74 Force Execute 185 ForeignKeys Available 201 FULL_EXT_JOIN 224 funzione COUNT 86 funzioni ABAP 92 HAVING 227 HOARD 42 abilitazione 42 disabilitazione 42 G Get Extended Column 201 GROUP_BY 225 GROUP_BY_SUPPORTS_COLUMN_INDEX 225 GROUP_BY_SUPPORTS_COMPLEX 226 GROUP_BY_SUPPORTS_CONSTANT 226 guida cscheck 46 file PRM 220 I IBM DB2 GROUP_BY_SUPPORTS_COMPLEX 226 GROUP_BY_SUPPORTS_CONSTANT 226 SELECT_SUPPORTS_NULL 235 IBM Informix SELECT_SUPPORTS_NULL 235 SQLDescribeParam Available 208 V5toV6DriverName 209 IBM Red Brick ANALYTIC_CLAUSE 221 LEFT_OUTER 229 RIGHT_OUTER 234 SELECT_SUPPORTS_NULL 235 Identifier Case 185 Identifier Quote String 186 Ignore Driver Load Failure 144 impostazione ActiveDataSources 150 Include Synonyms 186 Information Design Tool 33 informazioni sul manuale 19 InfoSet 90 installazione controllo del driver di accesso ai dati 53 directory Data Federator 134 file installati 25 Integer Max Length 107, 114, 187 INTERSECT 227 INTERSECT_ALL 228 INTERSECT_IN_SUBQUERY 228 Introscope 43 Introscope Available 187 J JavaBean informazioni sulle connessioni 64 JavaBean Class 198 URL Format 197 JavaBean Class 198 javabean.sbo 65 JDBC Connection Shareable 200 creazione di connessioni con Extensions 59 2013-07-02 Indice JDBC (segue) creazione di connessioni con i file SBO 58 Escape Character Available 200 ForeignKeys Available 201 generico 63 Include Synonyms 186 informazioni sulle connessioni 57 JDBC Class 202 JDBC ResultSet Concurrency 204 JDBC ResultSet Type 203 PrimaryKey Available 202 Shared Connection 203 tipi di dati 242 URL Format 197 JDBC Class 202 JDBC ResultSet Concurrency 204 JDBC ResultSet Type 203 jdbc.sbo 63 JOIN 229 L LEFT_EXT_JOIN 229 LEFT_OUTER 229 lettura di registri e analisi 157 LIKE_SUPPORTS_ESCAPE_CLAUSE 230 livelli di rete controllo della connettività con il middleware 54 elenco database supportati 48 selezione 150 livelli di rete supportati 48 Load Drivers On Startup 145 Locales 141 M manuale dell'accesso ai dati attività principali 21 convenzioni 21 destinatari 19 informazioni 19 novità 19 Max Pool Time 146 Max Rows 86, 95 Max Rows Available 188 Microsoft Windows 64 bit 32 middleware controllo della connettività con il livello di rete 54 elenco database supportati 50 verifica della disponibilità in un computer 52 261 MINUS 230 MINUS_ALL 231 MINUS_IN_SUBQUERY 231 modalità di distribuzione 28, 150 modalità libreria 150, 151, 156 modalità server 150, 157 MS Access DISCTINCT 223 MS SQL Server 170 MSOlap CLSID 211 origine dati ODBC generica 32, 67, 68 origini dati Microsoft Azure 88 Owners Available 189 P Native Int64 Available 188 Neoview CharSet 206 novità del manuale 19 Password Encryption 212 PERCENT_RANK_SUPPORTED 233 pool di connessioni informazioni 38 informazioni sulle connessioni di 39 prestazioni 84 PrimaryKey Available 202 Provider CLSID 210 PVL 89, 122 PVL Available 202 O Q ODBC Connection Status Available 206 driver DataDirect 170 Empty String 207 esposizione livello database in modalità server 151 informazioni sulle connessioni 66 ODBC Cursors 208 ODBC2 generica 67 ODBC3 generica 68 SQLMoreResults Available 208 Use DataDirect OEM Driver 209 ODBC Cursors 208 OLAP OLE DB MSOlap CLSID 211 OLE DB Enumerator CLSID 210 Provider CLSID 210 tipi di dati 248 Optimize Execute 189 Oracle esempio di controllo della connettività 55 Identifier Quote String 186 Include Synonyms 186 LEFT_OUTER 229 Optimize Execute 189 RIGHT_OUTER 234 stored procedure 36 tipi di dati 250 ORDER_BY 232 ORDER_BY_REQUIRES_SELECT 232 ORDER_BY_SUPPORTS_COLUMN_INDEX 232 origine dati JDBC generica 63 Qualifiers Available 190 query SAP 90 Query TimeOut Available 191 Quote Identifiers 191 Quoted Identifier 213 N R RANK_SUPPORTED 233 Recover Errors 213 Replace Current Owner With Database 214 requisiti connessioni 45 versione minima di Data Federator 133 RIGHT_EXT_JOIN 234 RIGHT_OUTER 234 S SAML 33, 122 SAP NetWeaver Gateway 76, 86 SBO JavaBean, esempio 65 SBO, file configurazione di una connessione JavaBean con Extensions 66 configurazione di una connessione JDBC con ClassPath 58 configurazione di una connessione JDBC con Extensions 59 installati 162 modifica 168 parametri Databases 173 parametri Defaults 173 2013-07-02 Indice SBO, file (segue) personalizzazione 168, 169 struttura 173 Verifica delle connessioni 169 visualizzazione 168 SEED_SAMPLING_SUPPORTED 235 SELECT_SUPPORTS_NULL 235 Servizi di connettività 28 servizio di connessione adattivo 28 servizio di connettività nativo 28 servizio Web, connessioni 107 Settings 141 Setup File Extension 146 Shared Connection 203 Single Sign On 33, 125, 127 Skip SAML SSO 191 SMB 74 SQL External Extension 147 SQL External File 192 SQL Parameter Extension 147 SQL Parameter File 192 SQL Server GROUP_BY_SUPPORTS_CONSTANT 226 LEFT_OUTER 229 RIGHT_OUTER 234 SQLDescribeParam Available 208 SQLMoreResults Available 208 SSL 122 SSO configurazione per Information Design Tool 125 configurazione per Web Intelligence 127 configurazione per Web Intelligence Rich Client 127 origini dati supportate 33 SSO Available 193 STATO 40 stored procedure creazione in Oracle 37 informazioni 35 262 stored procedure (segue) informazioni sulle connessioni JavaBean 64 limitazioni 35 Oracle 36 SAP HANA 37 Teradata 38 Strategies Extension 148 Strategies File 193 String Max Length 87, 107, 114, 194 SUBQUERY_IN_FROM 236 SUBQUERY_IN_IN 236 SUBQUERY_IN_WHERE 236 supporto a 64 bit ambiente UNIX 31 informazioni 31 supporto Microsoft Windows 32 Sybase Driver Behavior 212 esempio di controllo della connettività 55 LEFT_OUTER 229 Password Encryption 212 Quoted Identifier 213 Recover Errors 213 RIGHT_OUTER 234 tipi di dati 251 T TECHNICAL_COLUMN_NAME_PATTERN 237 Temp Data Dir 195 Teradata ANALYTIC_CLAUSE 221 Cost Estimate Available 207 SELECT_SUPPORTS_NULL 235 stored procedure 38 Text Size 213 tipi di dati file CSV 241 JDBC 242 OData 247 tipi di dati (segue) ODBC 244 OLE DB 248 Oracle OCI 250 SAP ERP 240 servizi Web 253 Sybase 251 XML 253 tipi di dati ODBC 244 tipi di dati servizio Web 253 tipi di dati XML 253 tipo 196 Traces 141 Transactional Available 118, 122, 195 U Unicode 196 UNION 237 UNION_ALL 238 UNION_IN_SUBQUERY 238 Universe Design Tool 33 universi provenienti da più origini 254 UNIX 64 bit 31 URL Format 197 Use DataDirect OEM Driver 209 uso di JNI 149 utilizzo della memoria 40 V V5toV6DriverName 209 Validate Configuration Files 148 Validate XML Streams 148 Verifica delle connessioni 169 versioni XI 3.x 57 voce dsn 135 X XML Max Size 198 2013-07-02
annuncio pubblicitario
Caratteristiche principali
- Accesso ai dati da varie sorgenti
- Supporto per sistemi operativi a 64 bit
- Supporto Single Sign On
- Stored procedure
- Connessioni JDBC e ODBC
- Pool di connessioni
- Bilanciamento del carico
- Configurazione dei parametri globali
- Configurazione dei parametri dei driver
Risposte e domande frequenti
Quali sono i componenti di una connessione?
Una connessione è composta da Connection Server, driver di accesso ai dati, file di configurazione e servizi di connessione.
Quali sono le funzionalità supportate dalle stored procedure?
Le funzionalità supportate dipendono dal tipo di database. Il manuale fornisce informazioni specifiche per Oracle, SAP HANA e Teradata.
Come si configuran i parametri globali?
I parametri globali vengono configurati nel file cs.cfg. Questo file contiene informazioni sulle impostazioni generali di Connection Server, come la modalità di distribuzione e i driver da caricare.
Come si configura il bilanciamento del carico?
Il bilanciamento del carico si configura nel file cs.cfg. È possibile definire diverse strategie per la selezione del server migliore.