Hướng dẫn python connect to oracle without client - python kết nối với oracle mà không cần ứng dụng khách

Bắt đầu nhanh: Phát triển các ứng dụng Python cho cơ sở dữ liệu Oracle

Hướng dẫn này chỉ cho bạn cách kết nối các ứng dụng Python với cơ sở dữ liệu Oracle bằng giao diện CX_Oracle. Giao diện này cho phép bạn nhanh chóng phát triển các ứng dụng thực thi các câu lệnh SQL hoặc PL/SQL. Các ứng dụng của bạn cũng có thể sử dụng các cuộc gọi soda lưu trữ tài liệu của Oracle. API CX_Oracle phù hợp với thông số kỹ thuật API cơ sở dữ liệu Python với số lượng bổ sung đáng kể và một vài loại trừ.

Các bước dưới đây hiển thị kết nối với cơ sở dữ liệu tại chỗ, nhưng nếu bạn muốn sử dụng cơ sở dữ liệu tự trị của Oracle trong Oracle Cloud thay thế [ví dụ từ dịch vụ luôn miễn phí], thì hãy xem các ứng dụng Python đang phát triển cho hướng dẫn cơ sở dữ liệu tự trị của Oracle.

Python cx_oracle trên Windows

Mở Allclose tất cả Close all

• 1. Cài đặt cơ sở dữ liệu Oracle

  • Nếu bạn chưa có quyền truy cập vào cơ sở dữ liệu Oracle, thì hãy tải xuống và cài đặt cơ sở dữ liệu Oracle XE theo các hướng dẫn này.

    Nhiêu tai nguyên hơn:

    Video cho thấy cách cài đặt cơ sở dữ liệu Oracle XE trên Windows và tiến hành quản trị cơ bản.

    Hướng dẫn cài đặt cơ sở dữ liệu Oracle cho Windows

  • Ngoài ra, nếu bạn đã có cơ sở dữ liệu nhưng nó nằm trên một máy tính từ xa, sau đó cài đặt các gói Oracle Instant "cơ bản" và "SQL*Plus" từ đây. Hãy nhớ cài đặt VS phân phối lại và thêm thư mục vào biến môi trường đường dẫn của bạn, theo hướng dẫn. Bạn sẽ cần biết chuỗi kết nối cho cơ sở dữ liệu và thay thế nó trong các hướng dẫn bên dưới.

  • Ngoài ra, nếu bạn muốn sử dụng cơ sở dữ liệu tự trị của Oracle trong Oracle Cloud [ví dụ: từ dịch vụ luôn miễn phí], thì hãy xem các ứng dụng Python đang phát triển cho hướng dẫn cơ sở dữ liệu tự trị của Oracle.

• 2. Tạo người dùng cơ sở dữ liệu

  Chúng tôi khuyên bạn nên sử dụng người dùng cơ sở dữ liệu mới cho hướng dẫn bắt đầu nhanh này.

  Mở một thiết bị đầu cuối lệnh và chạy công cụ dòng lệnh SQL*Plus, thay thế XXXX bằng mật khẩu người dùng đặc quyền mà bạn đã chọn trong quá trình cài đặt cơ sở dữ liệu. Nếu bạn không sử dụng cơ sở dữ liệu Oracle XE, thì cũng thay thế tên dịch vụ máy chủ và cơ sở dữ liệu của cơ sở dữ liệu của bạn cho "localhost/XEPDB1":

  sqlplus -l system/XXXX@localhost/xepdb1

  Tại dấu nhắc SQL>, nhập các câu lệnh sau [bạn có thể chọn tên người dùng khác, nếu bạn thích]:

  define USERNAME = demopython
  
  
  create user &USERNAME;
  
  alter user &USERNAME
      default tablespace users
      temporary tablespace temp
      quota unlimited on users;
  
  grant create session,
      create view,
      create sequence,
      create procedure,
      create table,
      create trigger,
      create type,
      create materialized view
      to &USERNAME;

  Vẫn còn trong SQL*Plus, đặt mật khẩu cho người dùng mới của bạn. Thay thế xxxx bằng mật khẩu hợp lệ và chạy:

  alter user &USERNAME identified by XXXX;

  Cuối cùng, thoát SQL*Plus

• 3. Cài đặt Python

• 4. Cài đặt cx_oracle

  Cài đặt cx_oracle:

  python -m pip install cx_Oracle --upgrade --user

  Tùy thuộc vào cài đặt Python của bạn, bạn có thể cần thực hiện lệnh

  define USERNAME = demopython
  
  
  create user &USERNAME;
  
  alter user &USERNAME
      default tablespace users
      temporary tablespace temp
      quota unlimited on users;
  
  grant create session,
      create view,
      create sequence,
      create procedure,
      create table,
      create trigger,
      create type,
      create materialized view
      to &USERNAME;

  0 thay thế.

  Để biết thêm hỗ trợ và tùy chọn, chẳng hạn như cài đặt phía sau proxy HTTP, xem cài đặt CX_ORACLE trên Windows.

• 5. Tạo ứng dụng Python

  • Sử dụng trình soạn thảo văn bản yêu thích của bạn, hãy tạo một ví dụ về tệp Python mới trong một thư mục bạn chọn. Nó nên chứa mã sau. Đảm bảo thụt lề giống như được hiển thị:example.py in a directory of your choice. It should contain the following code. Make sure the indentation is the same as shown:

    import cx_Oracle
    
    
    connection = cx_Oracle.connect[
        user="demopython",
        password="XXXXX",
        dsn="localhost/xepdb1"]
    
    print["Successfully connected to Oracle Database"]
    
    cursor = connection.cursor[]
    
    # Create a table
    
    cursor.execute["""
        begin
            execute immediate 'drop table todoitem';
            exception when others then if sqlcode  -942 then raise; end if;
        end;"""]
    
    cursor.execute["""
        create table todoitem [
            id number generated always as identity,
            description varchar2[4000],
            creation_ts timestamp with time zone default current_timestamp,
            done number[1,0],
            primary key [id]]"""]
    
    # Insert some data
    
    rows = [ ["Task 1", 0 ],
             ["Task 2", 0 ],
             ["Task 3", 1 ],
             ["Task 4", 0 ],
             ["Task 5", 1 ] ]
    
    cursor.executemany["insert into todoitem [description, done] values[:1, :2]", rows]
    print[cursor.rowcount, "Rows Inserted"]
    
    connection.commit[]
    
    # Now query the rows back
    for row in cursor.execute['select description, done from todoitem']:
        if [row[1]]:
            print[row[0], "is done"]
        else:
            print[row[0], "is NOT done"]

  • Sửa đổi ví dụ.py để sử dụng thông tin kết nối cơ sở dữ liệu của bạn trong cuộc gọi cx_oracle.connect []:example.py to use your database connection information in the cx_Oracle.connect[] call:

    • Người dùng: Sử dụng tên người dùng được tạo bởi tập lệnh SQL*Plus.: Use the username created by the SQL*Plus script.
    • Mật khẩu: Sử dụng mật khẩu của người dùng.: Use the user's password.
  • Lưu các thay đổi vào example.py.example.py.

• 6. Chạy ứng dụng Python

  Trong cửa sổ đầu cuối, chạy ứng dụng:

  Bạn sẽ thấy một thông báo mà bạn đã kết nối với cơ sở dữ liệu, năm hàng đã được chèn và danh sách tác vụ với trạng thái hoàn thành của mỗi tác vụ được trả lại cho cửa sổ thiết bị đầu cuối. Xin chúc mừng! Bạn đã truy vấn thành công cơ sở dữ liệu Oracle.

Bây giờ bạn đã hoàn thành hướng dẫn bắt đầu nhanh này, bạn nên tiếp tục với hướng dẫn cơ sở dữ liệu Python và Oracle đầy đủ này để tìm hiểu thêm về việc sử dụng CX_Oracle.

Thêm thông tin và tài nguyên về việc sử dụng cx_oracle có sẵn ở đây.

Python cx_oracle trên macOS [Intel x86]

Mở Allclose tất cả Close all

• 1. Cài đặt cơ sở dữ liệu Oracle

  Nếu bạn chưa có quyền truy cập vào cơ sở dữ liệu Oracle, thì hãy tải xuống và cài đặt cơ sở dữ liệu Oracle XE theo các hướng dẫn này.

  Để cài đặt cơ sở dữ liệu Oracle XE, hãy làm theo các hướng dẫn ở đây. Tóm tắt:

  • Cài đặt Oracle VM VirtualBox cho "Máy chủ OS X"

  • Cài đặt Vagrant

  • Tải xuống và giải nén cơ sở dữ liệu Oracle 18C XE Vagrant Cấu hình ZIP Tệp hoặc sử dụng Git để sao chép kho lưu trữ GitHub. Mở cửa sổ thiết bị đầu cuối và thay đổi thư mục Oracledatabase/18.4.0-XE, sau đó chạy Vagrant UpOracleDatabase/18.4.0-XE directory, then run vagrant up

    Khi kết luận, cơ sở dữ liệu sẽ được chạy. Thông báo xác nhận sẽ hiển thị mật khẩu cho các tài khoản đặc quyền.

• 2. Cài đặt gói oracle Instant Client Basic và SQL*Plus

• 3. Tạo người dùng cơ sở dữ liệu

  Chúng tôi khuyên bạn nên sử dụng người dùng cơ sở dữ liệu mới cho hướng dẫn bắt đầu nhanh này.

  Mở cửa sổ đầu cuối và thêm thư mục máy khách tức thì vào đường dẫn của bạn:

  export PATH=$HOME/Downloads/instantclient_19_8:$PATH

  Chạy công cụ dòng lệnh SQL*Plus, thay thế XXXX bằng mật khẩu người dùng đặc quyền mà bạn đã chọn trong quá trình cài đặt cơ sở dữ liệu. Nếu bạn không sử dụng cơ sở dữ liệu Oracle XE, thì cũng thay thế tên dịch vụ máy chủ và cơ sở dữ liệu của cơ sở dữ liệu của bạn cho "localhost/XEPDB1":

  sqlplus -l system/XXXX@localhost/xepdb1

  Tại dấu nhắc SQL>, nhập các câu lệnh sau [bạn có thể chọn tên người dùng khác, nếu bạn thích]:

  define USERNAME = demopython
  
  
  create user &USERNAME;
  
  alter user &USERNAME
      default tablespace users
      temporary tablespace temp
      quota unlimited on users;
  
  grant create session,
      create view,
      create sequence,
      create procedure,
      create table,
      create trigger,
      create type,
      create materialized view
      to &USERNAME;

  Vẫn còn trong SQL*Plus, đặt mật khẩu cho người dùng mới của bạn. Thay thế xxxx bằng mật khẩu hợp lệ và chạy:

  alter user &USERNAME identified by XXXX;

  Cuối cùng, thoát SQL*Plus

• 4. Cài đặt Python

  Cài đặt Python 3. Không thể sử dụng Python hệ thống trên macOS.

• 5. Cài đặt cx_oracle

  Bạn cần một trình biên dịch như Xcode từ App Store và cả các công cụ dòng lệnh của nó. Chúng có thể được cài đặt với

  define USERNAME = demopython
  
  
  create user &USERNAME;
  
  alter user &USERNAME
      default tablespace users
      temporary tablespace temp
      quota unlimited on users;
  
  grant create session,
      create view,
      create sequence,
      create procedure,
      create table,
      create trigger,
      create type,
      create materialized view
      to &USERNAME;

  1

  Cài đặt cx_oracle:

  sqlplus -l system/XXXX@localhost/xepdb1

  0

  Hãy chắc chắn rằng bạn đang sử dụng Python mới được cài đặt. Tùy thuộc vào cài đặt Python của bạn, bạn có thể cần thực hiện lệnh

  define USERNAME = demopython
  
  
  create user &USERNAME;
  
  alter user &USERNAME
      default tablespace users
      temporary tablespace temp
      quota unlimited on users;
  
  grant create session,
      create view,
      create sequence,
      create procedure,
      create table,
      create trigger,
      create type,
      create materialized view
      to &USERNAME;

  2, nếu điều này ghi đè cài đặt Python mặc định.

  Để biết thêm hỗ trợ và tùy chọn, chẳng hạn như cài đặt phía sau proxy HTTP, xem cài đặt CX_ORACLE trên macOS.

• 6. Tạo ứng dụng Python

  • Sử dụng trình soạn thảo văn bản yêu thích của bạn, hãy tạo một ví dụ về tệp Python mới trong một thư mục bạn chọn. Nó nên chứa mã sau. Đảm bảo thụt lề giống như được hiển thị:example.py in a directory of your choice. It should contain the following code. Make sure the indentation is the same as shown:

    sqlplus -l system/XXXX@localhost/xepdb1

    1

  • Sửa đổi ví dụ.py và đặt đường dẫn thích hợp vào thư mục máy khách tức thời của bạn trong cuộc gọi init_oracle_client [].example.py and set the appropriate path to your Instant Client directory in the init_oracle_client[] call.

  • Sửa đổi ví dụ.py để sử dụng thông tin kết nối cơ sở dữ liệu của bạn trong cuộc gọi cx_oracle.connect []:example.py to use your database connection information in the cx_Oracle.connect[] call:

    • Người dùng: Sử dụng tên người dùng được tạo bởi tập lệnh SQL*Plus.: Use the username created by the SQL*Plus script.
    • Mật khẩu: Sử dụng mật khẩu của người dùng.: Use the user's password.
  • Lưu các thay đổi vào example.py.example.py.

• 7. Chạy ứng dụng Python

  Trong cửa sổ đầu cuối, chạy ứng dụng:

  Bạn sẽ thấy một thông báo mà bạn đã kết nối với cơ sở dữ liệu, năm hàng đã được chèn và danh sách tác vụ với trạng thái hoàn thành của mỗi tác vụ được trả lại cho cửa sổ thiết bị đầu cuối. Xin chúc mừng! Bạn đã truy vấn thành công cơ sở dữ liệu Oracle.

Bây giờ bạn đã hoàn thành hướng dẫn bắt đầu nhanh này, bạn nên tiếp tục với hướng dẫn cơ sở dữ liệu Python và Oracle đầy đủ này để tìm hiểu thêm về việc sử dụng CX_Oracle.

Thêm thông tin và tài nguyên về việc sử dụng cx_oracle có sẵn ở đây.

Python cx_oracle trên Linux

Mở Allclose tất cả Close all

• 1. Cài đặt cơ sở dữ liệu Oracle

  • Nếu bạn chưa có quyền truy cập vào cơ sở dữ liệu Oracle, thì hãy tải xuống và cài đặt cơ sở dữ liệu Oracle XE theo các hướng dẫn này.

    Thêm tài nguyên: Hướng dẫn cài đặt cơ sở dữ liệu Oracle cho Linux

  • Ngoài ra, nếu bạn đã có cơ sở dữ liệu nhưng nó nằm trên một máy tính từ xa, thì hãy cài đặt các gói Oracle Instant "cơ bản" và "SQL*Plus" từ đây theo các hướng dẫn cài đặt. Bạn sẽ cần biết chuỗi kết nối cho cơ sở dữ liệu và thay thế nó trong các hướng dẫn bên dưới.

    Thêm tài nguyên: Video

  • Ngoài ra, nếu bạn muốn sử dụng cơ sở dữ liệu tự trị của Oracle trong Oracle Cloud [ví dụ: từ dịch vụ luôn miễn phí], thì hãy xem các ứng dụng Python đang phát triển cho hướng dẫn cơ sở dữ liệu tự trị của Oracle].

• 2. Tạo người dùng cơ sở dữ liệu

  Chúng tôi khuyên bạn nên sử dụng người dùng cơ sở dữ liệu mới cho hướng dẫn bắt đầu nhanh này.

  Mở cửa sổ đầu cuối và thêm thư mục máy khách tức thì vào đường dẫn của bạn:

  sqlplus -l system/XXXX@localhost/xepdb1

  2

  Chạy công cụ dòng lệnh SQL*Plus, thay thế XXXX bằng mật khẩu người dùng đặc quyền mà bạn đã chọn trong quá trình cài đặt cơ sở dữ liệu. Nếu bạn không sử dụng cơ sở dữ liệu Oracle XE, thì cũng thay thế tên dịch vụ máy chủ và cơ sở dữ liệu của cơ sở dữ liệu của bạn cho "localhost/XEPDB1":

  Chạy công cụ dòng lệnh SQL*Plus, thay thế XXXX bằng mật khẩu người dùng đặc quyền mà bạn đã chọn trong quá trình cài đặt cơ sở dữ liệu. Nếu bạn không sử dụng cơ sở dữ liệu Oracle XE, thì cũng thay thế tên dịch vụ máy chủ và cơ sở dữ liệu của cơ sở dữ liệu của bạn cho "localhost/XEPDB1":

  sqlplus -l system/XXXX@localhost/xepdb1

  Tại dấu nhắc SQL>, nhập các câu lệnh sau [bạn có thể chọn tên người dùng khác, nếu bạn thích]:

  define USERNAME = demopython
  
  
  create user &USERNAME;
  
  alter user &USERNAME
      default tablespace users
      temporary tablespace temp
      quota unlimited on users;
  
  grant create session,
      create view,
      create sequence,
      create procedure,
      create table,
      create trigger,
      create type,
      create materialized view
      to &USERNAME;

  Vẫn còn trong SQL*Plus, đặt mật khẩu cho người dùng mới của bạn. Thay thế xxxx bằng mật khẩu hợp lệ và chạy:

  alter user &USERNAME identified by XXXX;

  Cuối cùng, thoát SQL*Plus

• 4. Cài đặt Python

  Cài đặt Python 3. Không thể sử dụng Python hệ thống trên macOS.

  sqlplus -l system/XXXX@localhost/xepdb1

  6

• 4. Cài đặt cx_oracle

  Cài đặt cx_oracle:

  sqlplus -l system/XXXX@localhost/xepdb1

  7

  Hãy chắc chắn rằng bạn sử dụng Python3 thực thi.python3 executable.

  Để biết thêm hỗ trợ và tùy chọn, chẳng hạn như cài đặt phía sau proxy HTTP, xem cài đặt CX_ORACLE trên Linux.

• 5. Tạo ứng dụng Python

  • Sử dụng trình soạn thảo văn bản yêu thích của bạn, hãy tạo một ví dụ về tệp Python mới trong một thư mục bạn chọn. Nó nên chứa mã sau. Đảm bảo thụt lề giống như được hiển thị:example.py in a directory of your choice. It should contain the following code. Make sure the indentation is the same as shown:

    import cx_Oracle
    
    
    connection = cx_Oracle.connect[
        user="demopython",
        password="XXXXX",
        dsn="localhost/xepdb1"]
    
    print["Successfully connected to Oracle Database"]
    
    cursor = connection.cursor[]
    
    # Create a table
    
    cursor.execute["""
        begin
            execute immediate 'drop table todoitem';
            exception when others then if sqlcode  -942 then raise; end if;
        end;"""]
    
    cursor.execute["""
        create table todoitem [
            id number generated always as identity,
            description varchar2[4000],
            creation_ts timestamp with time zone default current_timestamp,
            done number[1,0],
            primary key [id]]"""]
    
    # Insert some data
    
    rows = [ ["Task 1", 0 ],
             ["Task 2", 0 ],
             ["Task 3", 1 ],
             ["Task 4", 0 ],
             ["Task 5", 1 ] ]
    
    cursor.executemany["insert into todoitem [description, done] values[:1, :2]", rows]
    print[cursor.rowcount, "Rows Inserted"]
    
    connection.commit[]
    
    # Now query the rows back
    for row in cursor.execute['select description, done from todoitem']:
        if [row[1]]:
            print[row[0], "is done"]
        else:
            print[row[0], "is NOT done"]

  • Sửa đổi ví dụ.py để sử dụng thông tin kết nối cơ sở dữ liệu của bạn trong cuộc gọi cx_oracle.connect []:example.py to use your database connection information in the cx_Oracle.connect[] call:

    • Người dùng: Sử dụng tên người dùng được tạo bởi tập lệnh SQL*Plus.: Use the username created by the SQL*Plus script.
    • Mật khẩu: Sử dụng mật khẩu của người dùng.: Use the user's password.
  • Lưu các thay đổi vào example.py.example.py.

• 6. Chạy ứng dụng Python

  Mở một cửa sổ thiết bị đầu cuối. Nếu bạn không đặt môi trường Oracle trên toàn cầu, thì hãy đặt lại. Điều này cho phép giao diện CX_Oracle của Python tìm các thư viện khách hàng cần thiết được bao gồm trong phần mềm cơ sở dữ liệu:

  sqlplus -l system/XXXX@localhost/xepdb1

  2

  Trong cửa sổ đầu cuối, chạy ứng dụng bằng Python 3 thực thi:

  Bạn sẽ thấy một thông báo mà bạn đã kết nối với cơ sở dữ liệu, năm hàng đã được chèn và danh sách tác vụ với trạng thái hoàn thành của mỗi tác vụ được trả lại cho cửa sổ thiết bị đầu cuối. Xin chúc mừng! Bạn đã truy vấn thành công cơ sở dữ liệu Oracle.

Bây giờ bạn đã hoàn thành hướng dẫn bắt đầu nhanh này, bạn nên tiếp tục với hướng dẫn cơ sở dữ liệu Python và Oracle đầy đủ này để tìm hiểu thêm về việc sử dụng CX_Oracle.

Thêm thông tin và tài nguyên về việc sử dụng cx_oracle có sẵn ở đây.