{"id":15017466,"url":"https://github.com/perl5-dbi/dbd-oracle","last_synced_at":"2025-10-22T08:55:39.659Z","repository":{"id":7779937,"uuid":"9149601","full_name":"perl5-dbi/DBD-Oracle","owner":"perl5-dbi","description":"Oracle database driver for the DBI module  ","archived":false,"fork":true,"pushed_at":"2025-06-01T05:42:24.000Z","size":20543,"stargazers_count":18,"open_issues_count":40,"forks_count":27,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-06-01T14:28:00.618Z","etag":null,"topics":["database-access","database-connector","dbd","dbi","oracle","oracle-database","oracle-db","perl","perl-database-interface","perl5"],"latest_commit_sha":null,"homepage":"http://search.cpan.org/dist/DBD-Oracle","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"gwenshap/DBD-Oracle","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/perl5-dbi.png","metadata":{"files":{"readme":"README","changelog":"Changes","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-04-01T15:22:15.000Z","updated_at":"2025-05-26T11:21:41.000Z","dependencies_parsed_at":"2023-01-16T20:16:05.305Z","dependency_job_id":null,"html_url":"https://github.com/perl5-dbi/DBD-Oracle","commit_stats":null,"previous_names":[],"tags_count":100,"template":false,"template_full_name":null,"purl":"pkg:github/perl5-dbi/DBD-Oracle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perl5-dbi%2FDBD-Oracle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perl5-dbi%2FDBD-Oracle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perl5-dbi%2FDBD-Oracle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perl5-dbi%2FDBD-Oracle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/perl5-dbi","download_url":"https://codeload.github.com/perl5-dbi/DBD-Oracle/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perl5-dbi%2FDBD-Oracle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280409346,"owners_count":26325747,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-22T02:00:06.515Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database-access","database-connector","dbd","dbi","oracle","oracle-database","oracle-db","perl","perl-database-interface","perl5"],"created_at":"2024-09-24T19:50:30.545Z","updated_at":"2025-10-22T08:55:39.267Z","avatar_url":"https://github.com/perl5-dbi.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"\nDBD::Oracle  --  an Oracle interface for Perl 5.\n\n   Copyright (c) 1994-2025  Tim Bunce, et. al.\n\n   See the COPYRIGHT section in the Oracle.pm file for terms.\n   See also the MAINTAINER section in the Oracle.pm\n\n   PLEASE READ THE ENTIRE README FILE CAREFULLY !\n\n   AND THEN READ ANY TROUBLESHOOTING POD FILES RELEVANT TO YOUR PLATFORM:\n\n        DBD::Oracle::Troubleshooting - General Tips\n        DBD::Oracle::Troubleshooting::Aix - AIX\n        DBD::Oracle::Troubleshooting::Cygwin - MS Windows using GCC\n        DBD::Oracle::Troubleshooting::Hpux - HP-UX\n        DBD::Oracle::Troubleshooting::Linux - Linux\n        DBD::Oracle::Troubleshooting::Macos - Mac OS\n        DBD::Oracle::Troubleshooting::Sun - Sun\n        DBD::Oracle::Troubleshooting::Vms - OpenVMS\n        DBD::Oracle::Troubleshooting::Win32 - MS Windows (32bit)\n        DBD::Oracle::Troubleshooting::Win64 - MS Windows (64bit)\n        DBD::Oracle::Troubleshooting::* - see if there's a file for your platform\n\n        DBD::Oracle::Troubleshooting::java.txt - Java/thread problem on Solaris\n\n   You may find these useful\n\n        README.help.txt - Help and hints on build problems\n\n*** QUICK START GUIDE:\n\n    The DBI requires one or more 'driver' modules to talk to databases.\n    Fetch, build and install the DBI module as per its README file.\n    You may then delete its source directory tree since it's no longer needed.\n    Use the 'perldoc DBI' command to read the DBI documentation.\n\n    Fetch this DBD::Oracle driver module and unpack it.\n    Follow the guidelines in this README file carefully.\n\n\n*** *BEFORE* BUILDING, TESTING AND INSTALLING DBD::Oracle:\n\n    Build, test and install Perl 5 (at least 5.6.1)\n    It is very important to TEST it and INSTALL it!\n\n    Build, test and install the DBI module (at least DBI 1.623).\n    It is very important to TEST it and INSTALL it!\n\n    Remember to *read* the DBI README file and this one CAREFULLY!\n\n    Install enough Oracle software to enable DBD::Oracle to build.\n\n    For Oracle Instant Client: that means install the following packages:\n        * The \"Basic\" package for the essential Oracle libraries.\n        * The \"SDK\" package for the headers and makefile.\n        * The \"SQL*Plus\" component is optional, but will help you check\n          your configuration and DBD::Oracle determine your Oracle version.\n\n    For full Oracle installs: that usually includes Pro*C and SQL*Net.\n    (That's not very specific because it varies between Oracle releases.).\n    As of release 1.22 support of Oracle clients before 9 was dropped.\n    The main reason for this is that next few versions of DBD::Oracle will\n    introduce a number of new features which will required a great deal of extra\n    coding to make the OCI 8 work.\n\n    As well it is getting harder to find an Oracle client 8 to test against as\n    well Oracle no longer supports clients before 9.\n\n    The ORACLE_HOME environment variable must point to the Oracle Home\n    used to create DBD::Oracle. (Not essential under MS Windows).\n\n*** MOST IMPORTANTLY:\n\n    Make sure Oracle is working and you can use the Oracle sqlplus\n    command to talk to the database from the machine you\n    want to build DBD::Oracle on. This often involves setting\n    environment variables like PATH, LD_LIBRARY_PATH, TWO_TASK etc.\n    Consult Oracle documentation for more details.\n\n    Only once you can connect to Oracle using sqlplus\n    should you try building and testing DBD::Oracle.\n\n*** BUILDING:\n\nExecute:\n\n    perl Makefile.PL            # use a perl that's in your PATH\n\nUse the perl that is first on your PATH. Then execute:\n\n    make\n\nIf you get an error like \"make: not found\" you need to find the\ndirectory that has the make command installed in it (e.g. /usr/ccs/bin\non Solaris) and add that to your PATH environment variable.\n\nDon't worry about most warnings when make runs, specifically ones like\n\"end-of-loop code not reached\", \"... due to prototype\",\n\"cast increases required alignment of target type\", etc.\n\nIf you have problems see the 'IF YOU HAVE PROBLEMS' section below.\nIf it builds without error you should then run 'make test'. For the\nmain tests to work they must be able to connect to an Oracle database.\n\nThe tests default to using a DSN of \"dbi:Oracle:\" which means you'll be\nconnected to the default database based on your TWO_TASK or ORACLE_SID\nenvironment variables. This default can be altered either by defining the\nORACLE_DSN environment variable or the DBI_DSN environment variable.\nSee the oracle_test_dsn() sub in t/nchar_test_lib.pl\n\nThe supplied tests will connect to the database using the value of the\nORACLE_USERID environment variable to supply the username/password.\nSo you should set that to a valid user (e.g. 'scott/tiger') and ensure that\nthis user has sufficient privileges to create, insert into, select from and\ndrop a table,  is also able to create, call and drop a procedure  and is able\nto select from systemtables like 'v$sessions'. Using 'system/manager' might\nwork but is not recommended! See also README.login.txt and TESTING.md.\n\nRun tests with:\n\n    make test\n\nIf the all the formal tests pass then, finally, run:\n\n    make install\n\n\n*** IF YOU HAVE PROBLEMS:\n\nMake sure you are using a recent perl (5.6.1 or later) and make\nsure it's on your PATH so you can say 'perl Makefile.PL' and not\n'/path/to/perl Makefile.PL'.\n\nIf you get compiler errors refering to Perl's own header files\n(.../CORE/*.h) then there is something wrong with your installation.\nIt is important to use a Perl that was built on the system you are using.\nIt's also important to use the same compiler that was used to build the\nPerl you are using.\n\nIf you have build/link or core dump problems try:\n        perl Makefile.PL -p\nor\n        perl Makefile.PL -nob\nIf it helps then please let me know (and please include a copy\nof the log from the failed default build, the log from the build that\nworked, plus the output of the \"perl -V\" command).\n\nDo not hand edit the generated Makefile unless you are completely sure\nyou understand the implications! Always try to make changes via the\nMakefile.PL command line and/or editing the Makefile.PL.\nYou should not need to make any changes. If you do please let us\nknow so that I can try to make it automatic in a later release.\n\nIf you just can't login or login takes a long time then read\nREADME.login.txt\n\nIf you have linking problems (errors related to libraries or functions)\nthen you could try forcing a 'static' build using:\n\n  make realclean\n  perl Makefile.PL LINKTYPE=static\n  make\n  make perl       (you'll need to use and install _this_ new perl binary)\n  make test\n  make -f Makefile.aperl inst_perl MAP_TARGET=perl  (install new perl)\n  make install                                      (install DBD::Oracle)\n\nBut that's not recommended these days.\n\n\u003e\u003e\u003e Also carefully read the README.help.txt file which is full of useful\n\u003e\u003e\u003e tips and workarounds for various problems of various systems.\n\n\n*** HOW TO REPORT PROBLEMS\n\nThis software is supported via the dbi-users@perl.org mailing list.\n(You don't need to subscribe to the list in order to post.)\n\nPlease do NOT post problems to comp.lang.perl.*, perl5-porters@perl.org,\nhttp://www.cpanforum.com/dist/DBD-Oracle, or google groups etc.\n\nIf you're *sure* the problem is a bug then you can post a bug report\nto https://github.com/perl5-dbi/DBD-Oracle/issues\nProblem reports that don't include sufficient detail (including the\ninformation listed below and how to reproduce the problem)\nare unlikely to get resolved.\n\nFor more information and to keep informed about progress you can join the\nmailing list. Send a message to dbi-users-help@perl.org for more information.\n\nPlease post details of any problems (or changes you needed to make) to\ndbi-users@perl.org.\n\n\n** IT IS IMPORTANT TO INCLUDE *ALL* THE FOLLOWING INFORMATION:\n\n1. A complete log of all steps of the build, e.g.:\n\n    (do a make realclean first)\n    perl Makefile.PL\n    make\n    make test\n\n    Make sure to include the 'stderr' output. The best way to do this is\n    to use the \"script\" command (man script). If that's not available\n    then \"command \u003e command.log 2\u003e\u00261\" (assuming you're not using csh).\n    The \"2\u003e\u00261\" is required (after the stdout redirect) to redirect stderr\n    to the same place.\n\n    If a test fails then also include the output of:\n\n    perl -Mblib t/\u003cname-of-failed-test\u003e.t\n\n2. Full details of which version of Oracle client and server you're using\n   (if it wasn't automatically found and printed by \"perl Makefile.PL\")\n\n3. The output of perl -V       (that's a capital V, not lowercase)\n\n4. If you get errors like \"undefined symbol\", \"symbol not found\",\n   \"undefined reference\", \"Text relocation remains\" or any similar\n   error then include the output of \"perl Makefile.PL -s XXX\"\n   where XXX is the name of one of the symbols.\n   Please don't send the entire output of this command,\n   just any obviously 'interesting' parts (if there are any).\n   See also the LINKTYPE=static notes above.\n\n5. If you get a core dump, rebuild DBD::Oracle with debugging\n   enabled by executing: perl Makefile.PL -g  (note the -g option)\n   then rerun the code to get a new core dump file, finally use a\n   debugger (gdb, sdb, dbx, adb etc) to get a stack trace from it.\n   NOTE: I may not be able to help you much without a stack trace!\n   It is worth fetching and building the GNU GDB debugger (\u003e=4.15) if\n   you don't have a good debugger on your system. If desperate try:\n     make perl; ./perl script; echo '$c' | adb ./perl core\n   Also see the Devel::CoreStack module on CPAN.\n\n6. If the stack trace mentions XS_DynaLoader_dl_load_file then rerun\n   make test after setting the environment variable PERL_DL_DEBUG to 2.\n\n7. If your installation succeeds, but your script does not behave\n   as you expect, the problem may be on your end. Before\n   sending to dbi-users, try writing a *small*, easy to use test case\n   to reproduce your problem. Also, use the DBI-\u003etrace method to\n   trace your database calls.\n\nIt is important to check that you are using the latest version before\nposting. If you're not then you're *very* likely to be told \"upgrade to\nthe latest\". You would do yourself a favour by upgrading beforehand.\n\nTry to help yourself first, then try to help others help you by following\nthese guidelines carefully.  And remember, please don't mail developers\ndirectly - use the dbi-users mailing list.\n\nRegards,\nTim.\n\n================================================================================\nExamples and other info:\n\nREADME.help.txt     -- READ IT FIRST IF YOU HAVE ANY PROBLEMS\nDBD::Oracle::Troubleshooting::* -- Various platform specific info\n\nDBI 'home page': http://dbi.perl.org\n\nDBI and DBD::Oracle are very portable. If Perl and Oracle run on a platform\nthen the chances are that DBD::Oracle will as well.\n\n================================================================================\n\nSee the large README.help.txt file for lots of hints and advice\nabout building and runtime issues.\n\nEnd.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperl5-dbi%2Fdbd-oracle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fperl5-dbi%2Fdbd-oracle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperl5-dbi%2Fdbd-oracle/lists"}