![\"twitter\"](\"https:\/\/blog.capdata.fr\/wp-content\/plugins\/social-media-feather\/synved-social\/image\/social\/regular\/48x48\/twitter.png\" "\\"Share")
<\/a><\/a>![\"linkedin\"](\"https:\/\/blog.capdata.fr\/wp-content\/plugins\/social-media-feather\/synved-social\/image\/social\/regular\/48x48\/linkedin.png\" "\\"Share")
<\/a>![\"mail\"](\"https:\/\/blog.capdata.fr\/wp-content\/plugins\/social-media-feather\/synved-social\/image\/social\/regular\/48x48\/mail.png\" "\\"Share")
<\/a>Connue pour de nombreux produits d\u00e9velopp\u00e9s pour PostgreSQL, Cybertec<\/a> a r\u00e9cemment mis \u00e0 jour son outil de migration de base de donn\u00e9es du moteur Oracle vers le moteur PostgreSQL.<\/p>\n Dans cet article, je vais vous expliquer la mise en place de l’outil, son installation, et vous montrer pas \u00e0 pas comment migrer une base de donn\u00e9es depuis Oracle vers PostgreSQL.<\/p>\n Pour l’exemple que je m’appr\u00eate \u00e0 vous montrer, je suis partie d’une machine Rocky Linux 8.7 (Green Obsidian) sur laquelle j’ai install\u00e9 une version 19c d’Oracle en multitenant et une version 13 de PostgreSQL.<\/p>\n Sur l’instance Oracle, j’ai utilis\u00e9 une base de donn\u00e9es sample<\/a> fournie par Oracle pour avoir de la mati\u00e8re \u00e0 migrer :<\/p>\n Cybertec nous met \u00e0 disposition trois types de licences pour son nouvel outil :<\/p>\n Ce test est r\u00e9alis\u00e9 avec la version standard de l’application, celle que l’on peut obtenir gratuitement. Pour l’obtenir, il suffit de vous rendre sur le site<\/a> de Cybertec, et de cliquer sur “Download” en dessous de la case de la Standard Edition.<\/p>\n La version actuelle du Migrator est la version 3.16.2, la mise \u00e0 jour est intervenue pendant que je faisais mes tests, j’ai donc d\u00fb mettre \u00e0 jour le produit pour pouvoir l’utiliser correctement.<\/p>\n Pour pouvoir t\u00e9l\u00e9charger l’outil, il vous faut vous inscrire en fournissant une adresse email sur laquelle le lien de t\u00e9l\u00e9chargement vous sera envoy\u00e9. Vous n’avez plus qu’\u00e0 transf\u00e9rer l’archive ainsi t\u00e9l\u00e9charg\u00e9e sur votre serveur d’installation.<\/p>\n Pour pouvoir fonctionner, Migrator n\u00e9cessite entre autre Git et Docker. L’application fonctionne sur son propre serveur, d’o\u00f9 l’utilisation de Docker. Cela permet entre autre de pouvoir installer facilement celle-ci car il ne s’agit que de d\u00e9ployer un container sur votre installation et le tour est jou\u00e9.<\/p>\n -> Installer Docker<\/p>\n Complete!<\/p>\n -> Installer Git :<\/p>\n Complete!<\/p>\n Une fois l’archive t\u00e9l\u00e9charg\u00e9e et upload\u00e9e sur votre serveur, la premi\u00e8re \u00e9tape c’est de d\u00e9compresser l’archive. Il est conseill\u00e9 de le faire avec l’utilisateur root pour avoir les droits suffisant \u00e0 faire les installations n\u00e9cessaires.<\/p>\n Une fois notre archive d\u00e9compress\u00e9e, on cr\u00e9\u00e9 la configuration de base pour notre Migrator.<\/p>\n Avant de passer \u00e0 la suite, on s’assure de bien d\u00e9marrer notre Docker :<\/p>\n On lance ensuite notre installation :<\/p>\n Pour pouvoir fonctionner, les nouvelles versions de Migrator n\u00e9cessitent un certificat TLS, on en g\u00e9n\u00e8re donc un :<\/p>\n Une fois notre installation termin\u00e9e, on peut d\u00e9marrer l’outil :<\/p>\n L’URL fournie par la fin de l’installation est l’url \u00e0 laquelle vous devez acc\u00e9der pour pouvoir voir s’afficher votre outil de migration web.<\/p>\n Important :<\/strong> Avant de vous connecter sur l’application, il y a certains droits qu’il faut s’assurer d’avoir.<\/p>\n Sur Oracle : Sur PostgreSQL :<\/p>\n Il ne nous reste plus qu’\u00e0 acc\u00e9der \u00e0 notre outil de migration, en se rendant au lien pr\u00e9cis\u00e9 \u00e0 la fin du start-up :<\/p>\n Une fois que nous avons correctement acc\u00e8s \u00e0 notre page de garde de Migrator, on peut donc commencer \u00e0 pr\u00e9voir une nouvelle migration. En cliquant sur Migration dans le menu \u00e0 gauche, on acc\u00e8de \u00e0 une nouvelle fen\u00eatre :<\/p>\n Sur cette nouvelle page, on peut cliquer sur Add New Migration afin d’acc\u00e9der \u00e0 la page de cr\u00e9ation d’une nouvelle migration<\/p>\n <\/p>\n Ce premier \u00e9cran est celui sur lequel on d\u00e9finit la connexion d’origine de la base de donn\u00e9es, donc notre connexion Oracle.<\/p>\n Les deux premiers champs du formulaire permettent de donner un nom et une description \u00e0 notre migration.<\/p>\n Ensuite, on donne une chaine de connexion pour notre base de donn\u00e9es source, le username qu’on a cr\u00e9\u00e9 plus t\u00f4t et le mot de passe qui lui est li\u00e9. On clique sur check, et si la connexion est ok, alors on aper\u00e7oit un message “Connection Success”. On peut donc cliquer sur “Next”.<\/p>\n <\/p>\n L’\u00e9cran suivant est l’\u00e9cran qui nous permet de g\u00e9rer le ou les sch\u00e9mas que l’on souhaite migrer. Dans notre cas, on s\u00e9lectionne le sch\u00e9ma OT et on clique sur “Next”.<\/p>\n La fen\u00eatre qui s’affiche permet de voir tout ce que l’outil Migrator nous permet de migrer. On peut voir que sur cette version standard, on ne sait pas migrer les partitions. On peut cliquer sur “Finish”.<\/p>\n L’\u00e9cran suivant est l’\u00e9cran de suivi de la migration en lui-m\u00eame. Il comporte de nombreuses fonctionnalit\u00e9s qui vous permettent de choisir les objets que vous voulez migrer ou non, en les d\u00e9sactivant on peut ais\u00e9ment ne pas importer certains objets.<\/p>\n En cliquant dans le menu d\u00e9roulant \u00e0 gauche, on peut d\u00e9rouler les tables et voir\u00a0 les champs dans ces tables. En cliquant dessus on peut m\u00eame aller modifier manuellement les types de ces champs pour leur migration, les contraintes, les index, les triggers…<\/p>\n Une fois nos modifications effectu\u00e9es, pour qu’elles soient prises en compte on peut cliquer sur le bouton “Save” en bas \u00e0 gauche, juste en dessous de la ligne.<\/p>\n Ainsi, on peut par exemple modifier le type des colonnes de cl\u00e9 primaire de Numeric \u00e0 Integer pour \u00e9viter d’avoir un probl\u00e8me lors de l’import, dans la mesure o\u00f9 PostgreSQL n’accepte pas les cl\u00e9 primaires de type Numeric.<\/p>\n Une fois que toutes nos modifications sont effectu\u00e9es, on peut cliquer sur le cercle en bas \u00e0 gauche pour ouvrir la console qui va nous permettre de lancer la migration.<\/p>\n Les quatre \u00e9tapes de la migration sont les suivantes :<\/b><\/p>\n La petite fen\u00eatre de log peut \u00eatre \u00e9tendue vers le haut, et elle vous permet d’avoir un visuel sur ce qui se passe pendant votre migration, et si des erreurs \u00e9ventuelles sont rencontr\u00e9es. La majeure partie des erreurs de migrations sont des probl\u00e8mes de type que l’on peut modifier directement sur l’interface pour ensuite relancer le processus.<\/p>\n <\/p>\n Quand notre migration est termin\u00e9e, c’est affich\u00e9 dans notre log, et on peut alors aller voir sur l’environnement PostgreSQL le r\u00e9sultat obtenu.<\/p>\n Notre sch\u00e9ma PostgreSQL qui ne contenait rien \u00e0 la base contient maintenant l’int\u00e9gralit\u00e9 des donn\u00e9es que notre sch\u00e9ma Oracle contenait.<\/p>\n Sur un march\u00e9 o\u00f9 de plus en plus de produits open-source nous permettent de faciliter des t\u00e2ches aussi d\u00e9licates que de la migration d’un environnement de base de donn\u00e9es \u00e0 un autre, Migrator et son interface graphique nous offrent une solution user-friendly avec une interface qui permet de simplifier les choses. Connue pour de nombreux produits d\u00e9velopp\u00e9s pour PostgreSQL, Cybertec a r\u00e9cemment mis \u00e0 jour son outil de migration de base de donn\u00e9es du moteur Oracle vers le moteur PostgreSQL. Dans cet article, je vais vous expliquer la mise en place… Continuer la lecture 1\u00e8re \u00e9tape : T\u00e9l\u00e9charger la version d\u00e9sir\u00e9e de Migrator.<\/h2>\n
\n
2\u00e8me \u00e9tape : Les d\u00e9pendances<\/h2>\n
sudo dnf check-update\r\nsudo dnf config-manager --add-repo https:\/\/download.docker.com\/linux\/centos\/docker-ce.repo\r\nsudo dnf install docker-ce docker-ce-cli containerd.io\r\n...\r\nInstalled:\r\ncontainer-selinux-2:2.189.0-1.module+el8.7.0+1154+147ffa21.noarch containerd.io-1.6.20-3.1.el8.x86_64 docker-buildx-plugin-0.10.4-1.el8.x86_64 docker-ce-3:23.0.4-1.el8.x86_64\r\ndocker-ce-cli-1:23.0.4-1.el8.x86_64 docker-ce-rootless-extras-23.0.4-1.el8.x86_64 docker-compose-plugin-2.17.2-1.el8.x86_64 fuse-common-3.3.0-16.el8.x86_64\r\nfuse-overlayfs-1.9-1.module+el8.7.0+1154+147ffa21.x86_64 fuse3-3.3.0-16.el8.x86_64 fuse3-libs-3.3.0-16.el8.x86_64 iptables-1.8.4-23.el8_7.1.x86_64\r\niptables-libs-1.8.4-23.el8_7.1.x86_64 libcgroup-0.41-19.el8.x86_64 libnetfilter_conntrack-1.0.6-5.el8.x86_64 libnfnetlink-1.0.1-13.el8.x86_64\r\nlibnftnl-1.1.5-5.el8.x86_64 libpcap-14:1.9.1-5.el8.x86_64 libslirp-4.4.0-1.module+el8.7.0+1154+147ffa21.x86_64 slirp4netns-1.2.0-2.module+el8.7.0+1154+147ffa21.x86_64<\/pre>\n
sudo dnf install git\r\n...\r\nInstalled:\r\nemacs-filesystem-1:26.1-7.el8.noarch git-2.31.1-3.el8_7.x86_64 git-core-2.31.1-3.el8_7.x86_64 git-core-doc-2.31.1-3.el8_7.noarch\r\nperl-Carp-1.42-396.el8.noarch perl-Data-Dumper-2.167-399.el8.x86_64 perl-Digest-1.17-395.el8.noarch perl-Digest-MD5-2.55-396.el8.x86_64\r\nperl-Encode-4:2.97-3.el8.x86_64 perl-Errno-1.28-421.el8.x86_64 perl-Error-1:0.17025-2.el8.noarch perl-Exporter-5.72-396.el8.noarch\r\nperl-File-Path-2.15-2.el8.noarch perl-File-Temp-0.230.600-1.el8.noarch perl-Getopt-Long-1:2.50-4.el8.noarch perl-Git-2.31.1-3.el8_7.noarch\r\nperl-HTTP-Tiny-0.074-1.el8.noarch perl-IO-1.38-421.el8.x86_64 perl-IO-Socket-IP-0.39-5.el8.noarch perl-IO-Socket-SSL-2.066-4.module+el8.6.0+957+15d660ad.noarch\r\nperl-MIME-Base64-3.15-396.el8.x86_64 perl-Mozilla-CA-20160104-7.module+el8.6.0+965+850557f9.noarch perl-Net-SSLeay-1.88-2.module+el8.6.0+957+15d660ad.x86_64 perl-PathTools-3.74-1.el8.x86_64\r\nperl-Pod-Escapes-1:1.07-395.el8.noarch perl-Pod-Perldoc-3.28-396.el8.noarch perl-Pod-Simple-1:3.35-395.el8.noarch perl-Pod-Usage-4:1.69-395.el8.noarch\r\nperl-Scalar-List-Utils-3:1.49-2.el8.x86_64 perl-Socket-4:2.027-3.el8.x86_64 perl-Storable-1:3.11-3.el8.x86_64 perl-Term-ANSIColor-4.06-396.el8.noarch\r\nperl-Term-Cap-1.17-395.el8.noarch perl-TermReadKey-2.37-7.el8.x86_64 perl-Text-ParseWords-3.30-395.el8.noarch perl-Text-Tabs+Wrap-2013.0523-395.el8.noarch\r\nperl-Time-Local-1:1.280-1.el8.noarch perl-URI-1.73-3.el8.noarch perl-Unicode-Normalize-1.25-396.el8.x86_64 perl-constant-1.33-396.el8.noarch\r\nperl-interpreter-4:5.26.3-421.el8.x86_64 perl-libnet-3.11-3.el8.noarch perl-libs-4:5.26.3-421.el8.x86_64 perl-macros-4:5.26.3-421.el8.x86_64\r\nperl-parent-1:0.237-1.el8.noarch perl-podlators-4.11-1.el8.noarch perl-threads-1:2.21-2.el8.x86_64 perl-threads-shared-1.58-2.el8.x86_64<\/pre>\n
Etape 3 : Installer Migrator<\/h2>\n
[root@oracle-02]# tar xf cybertec_migrator-v3.16.0-standard.tar.gz\r\n[root@oracle-02]# cd cybertec_migrator<\/pre>\n
[root@oracle-02 cybertec_migrator]# .\/migrator configure\r\n[OK] Generated environment file\r\n[INFO] Run '.\/migrator install --archive < archive_file > ' to complete setup<\/pre>\n
[root@oracle-02 cybertec_migrator]# systemctl start docker\r\n[root@oracle-02 cybertec_migrator]# systemctl status docker\r\n\u25cf docker.service - Docker Application Container Engine\r\nLoaded: loaded (\/usr\/lib\/systemd\/system\/docker.service; disabled; vendor preset: disabled)\r\nActive: active (running) since Tue 2023-05-02 08:53:00 UTC; 7s ago\r\nDocs: https:\/\/docs.docker.com\r\nMain PID: 3197 (dockerd)\r\nTasks: 8\r\nMemory: 119.0M\r\nCGroup: \/system.slice\/docker.service\r\n\u2514\u25003197 \/usr\/bin\/dockerd -H fd:\/\/ --containerd=\/run\/containerd\/containerd.sock<\/pre>\n
[root@oracle-02 cybertec_migrator]# .\/migrator install --archive ..\/cybertec_migrator-v3.16.0-standard.tar.gz\r\n[INFO] Reading version information from archive file '..\/cybertec_migrator-v3.16.0-standard.tar.gz'\r\n[INFO] Upgrading to version v3.16.0-standard\r\n[INFO] Extracting archive file '..\/cybertec_migrator-v3.16.0-standard.tar.gz'\r\n[INFO] Loading container images\r\nc9182c130984: Loading layer [==================================================>] 72.53MB\/72.53MB\r\n40599cfe08ec: Loading layer [==================================================>] 349.7kB\/349.7kB\r\n20b85315cea4: Loading layer [==================================================>] 102.9MB\/102.9MB\r\n61a5eccb8646: Loading layer [==================================================>] 9.454MB\/9.454MB\r\n459b6b5a3ba3: Loading layer [==================================================>] 3.584kB\/3.584kB\r\n8b2451f44e75: Loading layer [==================================================>] 61.95MB\/61.95MB\r\nff1b0bd4bc3d: Loading layer [==================================================>] 2.048kB\/2.048kB\r\n105a91dee35e: Loading layer [==================================================>] 115.5MB\/115.5MB\r\n8399b2b8ccbe: Loading layer [==================================================>] 3.173MB\/3.173MB\r\n4377e9cc2f2c: Loading layer [==================================================>] 25.5MB\/25.5MB\r\n8dbaeed3eff6: Loading layer [==================================================>] 2.56kB\/2.56kB\r\nLoaded image: cybertecpostgresql\/cybertec_migrator-core:v3.16.0-standard\r\n3af14c9a24c9: Loading layer [==================================================>] 84MB\/84MB\r\naf29ec691175: Loading layer [==================================================>] 62.5MB\/62.5MB\r\na0b795906dc1: Loading layer [==================================================>] 3.584kB\/3.584kB\r\n95457f8a16fd: Loading layer [==================================================>] 4.608kB\/4.608kB\r\n4d0bf5b5e17b: Loading layer [==================================================>] 3.584kB\/3.584kB\r\nff4557f62768: Loading layer [==================================================>] 7.168kB\/7.168kB\r\n0c1e2a4e5a14: Loading layer [==================================================>] 13.14MB\/13.14MB\r\nLoaded image: cybertecpostgresql\/cybertec_migrator-web_gui:v3.16.0-standard\r\n7cd52847ad77: Loading layer [==================================================>] 7.338MB\/7.338MB\r\ne2b55894f225: Loading layer [==================================================>] 12.8kB\/12.8kB\r\n96139409c02a: Loading layer [==================================================>] 2.048kB\/2.048kB\r\nc3ec93ee5b48: Loading layer [==================================================>] 233.7MB\/233.7MB\r\n99c761a4ed63: Loading layer [==================================================>] 60.42kB\/60.42kB\r\nb3357907ccb7: Loading layer [==================================================>] 2.56kB\/2.56kB\r\na7504fa091bf: Loading layer [==================================================>] 3.584kB\/3.584kB\r\na283b778659e: Loading layer [==================================================>] 15.87kB\/15.87kB\r\nLoaded image: postgres:13-alpine\r\n[INFO] Container images loaded\r\n[INFO] Archived container images\r\n[INFO] Upgraded to v3.16.0-standard\r\n[WARN] Could not find TLS\/SSL certificate\r\n[INFO] Run '.\/migrator configure --tls self-signed-cert' to generate a self-signed TLS\/SSL certificate<\/pre>\n
[root@oracle-02 cybertec_migrator]# .\/migrator configure --tls self-signed-cert\r\n[INFO] Generating self-signed TLS\/SSL certificate\r\n[+] Running 2\/1\r\n Network cybertec_migrator_common Created 0.2s\r\n Volume "cybertec_migrator_core_db-data" Created 0.0s\r\nGenerating a RSA private key\r\n.................................................................................+++++\r\n............+++++\r\nwriting new private key to '\/etc\/nginx\/certs\/nginx.key'\r\n-----\r\nYou are about to be asked to enter information that will be incorporated\r\ninto your certificate request.\r\nWhat you are about to enter is what is called a Distinguished Name or a DN.\r\nThere are quite a few fields but you can leave some blank\r\nFor some fields there will be a default value,\r\nIf you enter '.', the field will be left blank.\r\n-----\r\nCountry Name (2 letter code) [AU]:FR\r\n...\r\nEmail Address []:sfaveere@capdata-osmozium.com\r\n[OK] Generated self-signed TLS\/SSL certificate\r\n[INFO] Run '.\/migrator up' to switch to new version\r\n[WARN] Switching will abort running migrations<\/pre>\n
Etape 4 : D\u00e9marrage de l’application et premiers pas<\/h2>\n
[root@oracle-02 cybertec_migrator]# .\/migrator up\r\n[+] Running 3\/3\r\n Container cybertec_migrator-core_db-1 Healthy 6.2s\r\n Container cybertec_migrator-core-1 Started 6.6s\r\n Container cybertec_migrator-web_gui-1 Started 7.3s\r\n[OK] Started on 'https:\/\/***.**.*.**'<\/pre>\n
\nJ’ai cr\u00e9\u00e9 un compte Migrator avec des droits particuliers :<\/p>\n-- On the Oracle database\r\nCREATE USER migrator IDENTIFIED by migrator;\r\nGRANT CONNECT, SELECT_CATALOG_ROLE, SELECT ANY TABLE, FLASHBACK ANY TABLE TO migrator;<\/pre>\n
-- As PostgreSQL super user\r\nCREATE DATABASE demo;\r\nCREATE USER demo WITH PASSWORD 'demo';\r\nGRANT CREATE ON DATABASE demo TO demo;<\/pre>\n
![\"\"](\"https:\/\/blog.capdata.fr\/wp-content\/uploads\/2023\/05\/chrome_KzosVXNkHr-300x146.png\")
<\/a><\/p>\nEtape 5 : Pr\u00e9voir sa migration<\/h2>\n
![\"\"](\"https:\/\/blog.capdata.fr\/wp-content\/uploads\/2023\/05\/chrome_jkiw4VdWaK-300x146.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/blog.capdata.fr\/wp-content\/uploads\/2023\/05\/chrome_YnojWIrMdM-300x146.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/blog.capdata.fr\/wp-content\/uploads\/2023\/05\/chrome_Jl4fKVz8Cv-300x146.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/blog.capdata.fr\/wp-content\/uploads\/2023\/05\/chrome_4qGPRukA04-300x141.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/blog.capdata.fr\/wp-content\/uploads\/2023\/05\/chrome_69Ikavyp90-300x141.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/blog.capdata.fr\/wp-content\/uploads\/2023\/05\/chrome_rTqk14wyi7-300x141.png\")
<\/a><\/p>\n\n
![\"\"](\"https:\/\/blog.capdata.fr\/wp-content\/uploads\/2023\/05\/chrome_pweApXNKTc-300x141.png\")
<\/a><\/p>\npsql (13.10)\r\nType "help" for help.\r\npostgres=# \\c demo\r\nYou are now connected to database "demo" as user "postgres".\r\ndemo=# select * from ot.products;\r\nproduct_id | product_name | description | standard_cost | list_price | category_id\r\n------------+---------------------------------------------+-----------------------------------------------------------------------+---------------+------------+-------------\r\n228 | Intel Xeon E5-2699 V3 (OEM\/Tray) | Speed:2.3GHz,Cores:18,TDP:145W | 2867.51 | 3410.46 | 1\r\n248 | Intel Xeon E5-2697 V3 | Speed:2.6GHz,Cores:14,TDP:145W | 2326.27 | 2774.98 | 1\r\n249 | Intel Xeon E5-2698 V3 (OEM\/Tray) | Speed:2.3GHz,Cores:16,TDP:135W | 2035.18 | 2660.72 | 1\r\n...\r\n<\/pre>\n
Conclusion :<\/h2>\n
\nIl faut cependant garder en t\u00eate que cet outil n’est pas gratuit en dehors de sa version standard, et que pour pouvoir profiter des am\u00e9liorations de performance pour vos migrations, il faut acheter une licence aupr\u00e8s de Cybertec.
\nL’installation du produit en elle-m\u00eame ne pose aucune difficult\u00e9, et apr\u00e8s un peu de prise en main, il s’av\u00e8re relativement facile \u00e0 utiliser.<\/p>\n<\/a><\/a><\/a>","protected":false},"excerpt":{"rendered":"