Le référentielstockedesobjets quisontindispensablesaufonctionnementde DB2 Alphablox. Lefaitdedisposer detouslesoutilsd’unebase dedonnéespour assurerl’intégrité desdonnées garantitunsystème plusrobusteetplusfiable.
Configuration du référentiel DB2 Alphablox
L’étatinitial duréférentielDB2Alphabloxestétablipendantleprocessus
d’installation. LeréférentielDB2Alphabloxutilisedeuxfournisseursdeservicespour accéder auréférentiel,selonsontype :lefournisseurdeservicesdesystèmede fichiersDB2Alphabloxetlefournisseurdeservicesdebasededonnées DB2 Alphablox.LefournisseurdeservicesdesystèmedefichiersDB2Alphabloxest l’étatpar défaut.Toutes lesbasesdedonnées relationnellesquisontprises en chargepar DB2Alphabloxsontdesbasesde donnéesprisesenchargepourle fournisseurdeservicesdebasededonnéesDB2Alphablox.Pourplus d’informationssurlaspécificationdutype deréférentielpendantleprocessus d’installation etsurlesbasesdedonnéesrelationnellesprisesencharge,voirle Guided’installation.
Vérification du type de référentiel
Pour vérifierlefournisseurde servicesduréférentielquiest utilisépourvotre serveur,effectuezlesétapessuivantes:
1. Assurez-vousqueDB2Alphabloxestencoursd’exécution.
2. Connectez-vousàlapaged’accueildeDB2Alphabloxentantqu’utilisateur adminou entantqu’utilisateur membredu groupeadministrateur.
3. Cliquez surl’ongletAdministration.LapageGeneralsousl’onglet Administrations’affiche.
4. Danslasectiondespropriétésgénéralesdelapage,cliquez surleliendu gestionnairederéférentielspourafficherlespropriétésduréférentielDB2 Alphablox.
L’entréecorrespondantaufournisseurdeservicesderéférentiel indiquele fournisseurdeservices JNDIutilisé,l’entréedel’adaptateur debasede données indiquelepiloteJDBCutilisé, etlesautresentréesindiquentdes informationsde configurationde lasourcededonnées.Silefournisseurde services desystèmede fichiersestutilisé, l’entréed’emplacement du référentiel indiquelerépertoire destockagedesfichiersde référentiel.
Remarque: Vousnepouvezpasmodifierletypederéférentieldanslapagedes propriétésdugestionnairederéférentiels.Pourmodifierletypede référentiel,vousdevez utiliserl’utilitairedeconversion.
Utilisation de l’utilitaire de conversion du registre
Si vousvoulezchangerletypederéférentiel(parexemple,desystèmede fichiers enunebasede donnéesOracle),vousdevez exécuterl’utilitairede conversiondu registre. L’utilitairedeconversionest unprogrammeJavaquis’exécutedansune fenêtredelignede commande(fenêtreMS-DOSsouslessystèmesWindows,xterm ou autrefenêtredecommandesouslessystèmesLinuxetUNIX).Ilcréelestables et/ou lesfichiersnécessairespour déplacerunréférentielouregistreDB2
Alphabloxd’unemplacementversunautre.Vouspouvez utiliserl’utilitairede conversionduregistrepourdéplacerunréférentield’unsystèmede fichiersvers unautresystème defichiers,d’unsystème defichiers versunebase dedonnées, d’une basededonnées versunsystème defichiers,oud’une basededonnéesvers uneautre basededonnées.
Démarrage de l’utilitaire de conversion du registre
Vouspouvezdémarrerl’utilitairedeconversionduregistreàpartirdumenu DémarrersouslessystèmesWindowssurlesquelsDB2Alphabloxestinstalléou enexécutantlefichier suivantsouslessystèmesWindows.
Important: Vousdeveztoujours arrêterDB2Alphabloxavantd’exécuterl’utilitaire de conversionduregistre.
<db2alphablox_dir>/Tools/convert/ConvertRepository.exe
ou enexécutantlefichiersuivantsouslessystèmesLinuxetUNIX :
<db2alphablox_dir>/Tools/convert/ConvertRepository
où <db2alphablox_dir>représentelerépertoiredanslequelDB2Alphabloxest installé.
Options interactives de ligne de commande de l’utilitaire de conversion du registre
Le tableausuivant décritlesoptionsinteractives delignedecommandedumenu principalde l’utilitairedeconversiondu registre:
Option Description
1 SetDB2AlphabloxFileManager Root
Définitlerépertoirepourl’emplacementdes fichiersderéférentielutiliséspourunréférentiel desystèmedefichiers.Lerépertoiredoitêtreun répertoireDB2Alphabloxvalidepouréviter l’échecdel’opérationetlagénérationd’une erreur.
2 SetDB2AlphabloxInstance Name
Sélectionnel’instancedeDB2Alphabloxàlaquelle l’utilitairedeconversionduregistreaccédera.
L’instancespécifiéedoitêtreuneinstanceDB2 Alphabloxvalidepouréviterl’échecde l’opérationetlagénérationd’uneerreur.
Option Description 3 ConvertOneRepositoryto
Another
Convertitunréférentielexistantenunautre référentiel,endéplaçanttouteslesdonnées nécessairesd’unréférentielàl’autre.D’autres optionspermettentdeconvertirleréférentield’un fichierenunebasededonnées,d’unebasede donnéesenunfichier,d’unfichierenunautre fichieretd’unebasededonnéesenuneautre basededonnées.Vousêtesinvitéàutiliserl’une desoptionssuivanteslorsquevousconvertissez unréférentiel:
v COPY:copielecontenud’unréférentieldans unautre,toutenlaissantleréférentieloriginal àsaplace.
v
MOVE:déplacelecontenud’unréférentiel versunautreréférentiel.Leréférentieloriginal estsupprimé.
Vousêteségalementinvitéàutiliserl’unedes optionssuivantespourleréférentielde destination:
v
NEW:créeunréférentielàladestination indiquée.
v UPDATE:metàjourlesdonnéesdansle référentieldedestinationdepuislerépertoire sourceaulieudeleremplacerparunnouveau référentiel.
v OVERWRITE:recréelestablesetremplace touteslesdonnéesdansleréférentielde destinationparlesdonnéesduréférentiel source.L’optionOVERWRITEneconservepas lesdonnéesdansleréférentieldedestination.
4 CreateanEmptyDatabase Repository
Créelestablesdansunebasededonnéesrequise pourleréférentielDB2Alphablox.Cetteoption permetdecréeruniquementlestablesavecleur contenuinitial;ellenelesremplitpasavecdes objetsderéférentiel.
5 VerifyandRepairaRepository Vérifiesiunréférentielprésentedesproblèmeset, lecaséchéant,signalecesproblèmes.Inclutdes optionspermettantdevérifierlesréférentielsde fichiersetdebasededonnées.Danslecasdes référentielsdebasesdedonnées,cetteoption permetégalementdecorrigercertainsproblèmes.
6 ChangeDB2Alphabloxtousea differentRepository
RenvoieuneinstancedeDB2Alphabloxversun autreréférentiel.Leréférentielverslequelvous pointezdoitexisteretêtreaccessibledepuisla machineDB2Alphablox.
Option Description
7 ConversionUtilityOptions Permetdepasserdumodedemessageprolixeau modedemessagenormaletinversementpour l’utilitaireetd’effacerlamémoiretampon contenantl’historiquequel’utilitairede conversionutilisepourmémoriserles informationsentrées.Fournitégalementune optionpermettantdespécifierdifférentsfichiers deschémaDDLpourcréerlestablesde référentiel.NespécifiezpasdefichiersDDL différentssanslesavoirtestésdemanière approfondie.
8 Exit Quittel’utilitairedeconversionduregistre.
L’utilitairede conversionduregistreconserveunfichierjournalintitulé repositoryconvert.log danslequel sontconsignéestouteslesactivitésdela session deconversiondel’utilitaire.Lefichierrepositoryconvert.logsetrouve danslemêmerépertoire quel’utilitairede conversion(<db2alphablox_dir>/Tools/
convert).
Conversion d’un système de fichiers en base de données
Avantde convertirunréférentield’unsystèmede fichiersenunebasededonnées, vousdevez disposerdesinformationssuivantes:
v lechemincompletversvotre référentieldesystème defichiers(par exemple, d:\alphablox\repository),
v lesinformations deconnexionà labasededonnées.
Laprocéduresuivantedécritlesétapesnécessairespourconvertir unréférentiel DB2Alphabloxdesystèmede fichiersenbasede données.
1. Arrêtez DB2Alphablox.
2. Démarrezl’utilitairedeconversionderegistre(pourplusdedétails,voir
«Démarragedel’utilitairede conversiondu registre»,à lapage121).
3. Sélectionnezl’option3,Convertonerepositorytoanother,enentrantle numéro 3etenappuyantsurlatoucheEntrée.
4. Sélectionnezl’option1,Convertfileto database,enentrantlenuméro 1eten appuyantsur latoucheEntrée.
5. ConfirmezlerépertoireracineduréférentielenappuyantsurlatoucheEntrée.
Remarque: Silerépertoireindiquécomme étantlerépertoire pardéfautn’est paslerépertoire duréférentiel,assurez-vous quevousaccédez bienàl’instancecorrectedeDB2Alphablox.L’instancepardéfaut à laquelleaccèdel’utilitairedeconversionderegistreestlenom del’instanceinstallée,quipar défautindique
AlphabloxAnaltyics.Silenomde votreinstanceest différent, quittezlaséquenceencoursetdéfinissezlenomd’instance correctà partirdel’option2 danslemenuprincipal.
6. Si touslesélémentssontcorrects,sélectionnezContinuerenentrantle numéro 1etenappuyantsurlatoucheEntrée.
7. Sélectionnezlabasededonnées quicorrespondàvotreserveurde basede données. Parexemple,sivousutilisezOracle8.1.7,entrez2.
8. Entrezlesinformations deconfigurationpourvotrebasede donnéeslorsque vousy êtesinvité.
9. Si touslesélémentssontcorrects,sélectionnezContinuerenentrantle numéro 1etenappuyantsurlatoucheEntrée.
10. Entrez COPYouMOVE.COPY conservel’ancienréférentielà saplaceeten créeunecopie dansleréférentielde destination;MOVEsupprimel’ancien référentieletencréeunnouveau dansleréférentieldedestination.
11. EntrezNEW,UPDATEou OVERWRITE.UtilisezNEWpourcréerun référentielavecdenouvellestabless’iln’enexistepasunedéjà.Utilisez UPDATEpour conserverlastructurede tableexistantedu référentieletla mettreà jouraveclesdonnéesdu référentielsource.UtilisezOVERWRITE poursupprimerlesanciennes donnéesettablesde basededonnées,etrecréer de nouvellestablesetdonnéesà leurplace.
12. Si vousvoulezquelenouveauréférentielsoitutiliséparvotre instancede DB2Alphablox, entrezYàl’inviteUpdateDB2Alphablox pourutiliserle nouveau référentiel.
13. Pour mettreàjourlespropriétésnécessairespour l’instanceDB2Alphablox, sélectionnezALLà l’inviteUpdateDB2AlphabloxProperties.ALLindiquela conversiondetoutes lespropriétésduserveur;SPECIFICindiquela
conversiondespropriétésdu serveurspécifiquesà lamachinelocale
uniquement(etnondespropriétésgroupées);GLOBALindiquelaconversion despropriétéspartagéespar lagrappeuniquement(etnonlesentréesdela machine locale).NONEindique lamodification d’aucunepropriétédans l’instanceDB2Alphablox.
14. Si touslesélémentssontcorrects,sélectionnezContinuerenentrantle numéro 1etenappuyantsurlatoucheEntrée.
15. Alafindelaconversion, vousrevenezaumenuprincipal.Entrez8pour quitterl’utilitairedeconversionduregistre.
Conversion d’une base de données en système de fichiers
Avantde convertirunréférentield’unebasede donnéesenunsystèmedefichiers, vousdevez disposerdesinformationssuivantes:
v lesinformationsdeconnexionaurépertoirede labase dedonnées,
v lechemincompletversl’emplacementvoulupourleréférentieldusystèmede fichiers(parexemple,d:\alphablox\Référentiel)
Laprocéduresuivantedécritlesétapesnécessairespour convertirunréférentiel DB2Alphabloxdebasede donnéesensystèmede fichiers.
1. Arrêtez DB2Alphablox.
2. Démarrezl’utilitairedeconversionderegistre(pourplusdedétails,voir
«Démarragedel’utilitaire deconversiondu registre»,à lapage121).
3. Sélectionnezl’option3,Convertonerepositorytoanother,enentrantle numéro 3etenappuyantsurlatoucheEntrée.
4. Sélectionnezl’option2,Convertdatabasetofile,enentrantlenuméro 2eten appuyantsur latoucheEntrée.
5. Sélectionnezlabasede donnéesquicorrespondàvotreserveurde basede données. Parexemple,sivousutilisezOracle 8.1.7,entrez2.
6. Entrez lesinformations deconfigurationpourvotrebasede donnéeslorsque vousy êtesinvité.
7. Si touslesélémentssontcorrects,sélectionnezContinuerenentrantle numéro 1etenappuyantsurlatoucheEntrée.
L’utilitairede conversionduregistretenteradeseconnecteràlabasede données.
8. Entrezlerépertoirepourlaracine duréférentieldedestination,puisappuyez sur latoucheEntrée.
9. Si touslesélémentssontcorrects,sélectionnezContinuerenentrantle numéro 1etenappuyantsurlatoucheEntrée.
10. EntrezCOPY ouMOVE.COPYconservel’ancienréférentielà saplaceeten créeunecopie dansleréférentielde destination;MOVEsupprimel’ancien référentieletencréeunnouveaudansleréférentieldedestination.
11. EntrezNEW,UPDATEou OVERWRITE.UtilisezNEWpourcréerun référentiels’iln’enexistepasundéjà.UtilisezUPDATEpourconserverla structure existantedu référentieletlamettreàjouraveclesdonnéesdu référentielsource.UtilisezOVERWRITE poursupprimerlesanciennes données etstructuresetrecréerlesnouvellesstructuresetdonnées àleurplace.
12. Si vousvoulezquelenouveauréférentielsoitutiliséparvotre instancede DB2Alphablox, entrezYàl’inviteUpdateDB2Alphablox tousetheNew Repository.
13. Pour mettreàjourlespropriétésnécessairespour l’instanceDB2Alphablox, sélectionnezALLà l’inviteUpdateDB2AlphabloxProperties.ALLindiquela conversiondetoutes lespropriétésduserveur;SPECIFICindiquela
conversiondespropriétésduserveurspécifiquesà lamachinelocale
uniquement(etnondespropriétésgroupées);GLOBALindiquelaconversion despropriétéspartagéespar lagrappeuniquement(etnonlesentréesdela machine locale).NONEindique lamodification d’aucunepropriétédans l’instanceDB2Alphablox.
14. Si touslesélémentssontcorrects,sélectionnezContinuerenentrantle numéro 1etenappuyantsurlatoucheEntrée.
15. Alafindelaconversion, vousrevenezaumenuprincipal.Entrez8pour quitterl’utilitairedeconversionduregistre.
Configuration d’une instance afin qu’elle utilise un référentiel existant
Avantde configureruneinstance deDB2Alphabloxafinqu’elleutilise un
référentielexistant,rassemblezlesinformationsdeconnexion pourleréférentielde labase dedonnéesauquel vousvoulezvousconnecter.
Laprocéduresuivantedécritlesétapesnécessairespourconfigureruneinstance de DB2Alphabloxafinqu’elleutiliseunréférentielDB2Alphabloxexistant.
1. ArrêtezDB2Alphablox.
2. Démarrezl’utilitairedeconversionderegistre(pourplusde détails,voir
«Démarragedel’utilitairedeconversionduregistre»,àlapage121).
3. Sélectionnezl’option6,ChangeDB2Alphabloxto useadifferent repository, enentrantlenuméro 6etenappuyantsurlatoucheEntrée.
4. Sélectionnezl’option2,Databaserepositoryisthetarget,enentrantle numéro 2etenappuyantsurlatoucheEntrée.
5. Sélectionnezlabasededonnées quicorrespondà votreserveurdebase de données.Par exemple,sivousutilisezOracle8.1.7,entrez2.
6. Entrezlesinformationsde configurationpourvotre basededonnées lorsque vousyêtesinvité.
7. Sitous lesélémentssontcorrects,sélectionnezContinuerenentrantle numéro 1etenappuyantsurlatoucheEntrée.
L’utilitairedeconversionduregistretenteradeseconnecterà labasede données,puismettraàjourl’instancede DB2Alphabloxafinqu’elleutilise le référentielspécifié.
8. Entrez8 pourquitterl’utilitairede conversionduregistre.
Syntaxe de ligne de commande
Dans laplupartdescas,vouspouvezutiliser l’utilitairedeconversiondu registre enmodeinteractif,comme décritdanslessectionsprécédentes.Vouspouvez, toutefois,utiliser desoptionsdelignedecommandepourspécifierdifférents fichiers DDLdebasede donnéesoupourexécuterl’utilitairedeconversionentant quepartied’unscriptautomatisé.Lasyntaxedebasepour l’utilitairederegistre est lasuivante:
java -cp [chemin_de_classe] com.alphablox.util.convert.Convert opération
destination [source] [arguments]
où :
chemin_de_classe estlechemindelaclasseJava pourl’instancede DB2Alphablox.Recherchezdanslesfichiersde démarragedeDB2Alphablox(par exemple, AnalysisServer.batsouslesplateformesWindows etAnalysisServer.shsouslesplateformesLinuxet UNIX)unexempledechemin_de_classe.
opération estl’opération d’utilitairedeconversiondu registre àexécuter. Pourvoirunedescriptiondes
opérationsdisponibles,reportez-vous àlasection
«Descriptionsdesopérations»,àlapage126.
destination estuncheminrelatifouabsoluversunfichierde propriétésdécrivantleréférentielde destination.
Pourvoirdesmodèlesdefichiers dedestination, reportez-vousà lasection«Modèlesdefichiers de propriétéssourceetdedestination»,à lapage128.
source estuncheminrelatifouabsoluversunfichierde propriétésdécrivantleréférentielsource.Vous devezspécifierl’argumentsource pourles
opérationsdecopie etdedéplacement.Pourvoir desmodèlesdefichiers dedestination,
reportez-vousà lasection«Modèlesdefichiers de propriétéssourceetdedestination»,à lapage128.
arguments estunouplusieursdesargumentsspécifiés dansla tabledans«Arguments»,à lapage127.
Si aucuneopération,destination,sourceouaucunargumentn’estspécifié,l’utilitaire de conversiondu registres’exécuteenmodeinteractif.
Descriptions desopérations: Le tableausuivantdécrit lesopérations disponibles pour l’utilitairedeconversiondu registre.
Opération Description
HELP Affichel’aidedelignedecommande.
CHANGE Changeleréférentielactifenréférentielde destination.
COPY Conserveleréférentielsourceàsaplaceetencrée unecopiedansleréférentieldedestination.
DELETE Supprimede façonpermanenteleréférentielde destination.
MOVE Supprimeleréférentielsourceetcréeunréférentiel dansleréférentieldedestination.
NEW|CREATE Créeunréférentieldansleréférentielde destinationetleremplitaveclesvaleursdu référentielpar défaut.
VERIFY Exécutedesopérations devalidationsurle référentielde destinationetrapportelesrésultats.
Arguments: Letableausuivantdécritlesargumentsdisponiblespourl’utilitaire de conversiondu registre.
Argument Description
DEBUG Fournitdesinformationsde débogage
supplémentairespouraideraudiagnostic des problèmes.
LOG:fichier Spécifielenomdufichierjournalde l’utilitairede conversion,danslequelsont consignéestoutes les activitésdel’utilitaire.Lenompardéfautdufichier estrepositoryconvert.log.
SERVER:nom_instance Spécifielenomd’instancedel’instancedeDB2 Alphablox.L’argumentSERVERest requis.
OVERWRITE UtiliséavecuneopérationNEW,MOVE,COPYou CHANGE,l’argumentOVERWRITE supprimeles anciennesdonnées etstructuresdansleréférentiel dedestinationetrecréelesnouvellesstructureset donnéesà leurplace. Sanscetargument,l’utilitaire deconversionduregistres’arrêtes’ildétecteun référentielexistantàladestination.
PROPS:option Utiliséavecl’argumentSERVER:nom_instance, spécifielespropriétésde serveuràmettreà jour surleréférentielde destination.Lesvaleurspour optionsontlessuivantes:
v ALL:indiquelaconversiondetoutes les propriétésdeserveur.
v GLOBAL:indiquelaconversiondespropriétés partagéesparlagrappeuniquement(etnonles entréesde lamachinelocale).
v SPECIFIC:indiquelaconversiondespropriétés deserveurspécifiquesà lamachine locale uniquement(etnonlespropriétésgroupées).
UPDATE Spécifiequ’une opérationMOVEouCOPYdoit mettreàjourleréférentieldedestinationavecdes informationsduréférentielsourceplutôtquede remplacerlecontenuduréférentieldedestination.
DDL:fichier Remplacelefichier deschémaDDLpar défaut utilisépour lacréation destables, desindexetdu contenuinitial duréférentielde basededonnées.
Important: Soyezextrêmementprudentslorsque vousutilisezcetargument.
USEDEST Lorsqu’ilestspécifié,cetargumentmodifieles propriétésdeserveurpourutiliserleréférentielde destination.Sil’argumentn’estpasspécifié,les propriétésderéférentieldu serveurnesontpas modifiées.
Modèlesdefichiersdepropriétéssourceet dedestination: Cettesectionmontre lecontenudesmodèlesde fichierssourceetde destinationutilisésavecl’utilitaire de conversiondu registre.Lesfichiers depropriétésspécifientletypede
référentiel, lesinformationsdeconnexiondu référentiel,l’emplacementdesfichiers de propriétésdu référentielsurl’ordinateurexécutantDB2Alphablox,ainsiquele nom dufichierDDL.
L’exemple suivantmontreunfichierde propriétéspourunréférentielsetrouvant dansunebasede donnéesOraclesur unserveurnommé oracle817:
RepositoryTarget=JDBCTarget
java.naming.factory.initial=com.alphablox.jndisp.AlphabloxContextFactory java.naming.provider.url.server=oracle817
java.naming.provider.url.port=1521 java.naming.provider.url.sid=orcl817
database_driver=oracle.jdbc.driver.OracleDriver fileroot=C:\alphablox\analytics\repository\servers\
commandfile=oracle.dmlsql user=user
password=password
L’exemple suivantmontreunfichierde propriétéspourunréférentielsetrouvant dansunsystèmede fichiers:
RepositoryTarget=ABXTarget
java.naming.factory.initial=com.alphablox.jndisp.AlphabloxContextFactory java.naming.provider.url=C:\alphablox\analytics\repository\
fileroot=C:\alphablox\analytics\repository\servers\