Skip to content

Commit

Permalink
AI Vector Searchチュートリアルの追加
Browse files Browse the repository at this point in the history
  • Loading branch information
r-deguchi committed May 19, 2024
1 parent 3fadd7f commit 7c23e20
Show file tree
Hide file tree
Showing 17 changed files with 574 additions and 41 deletions.
18 changes: 7 additions & 11 deletions _pages/ai-vector-search.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,26 +31,22 @@ Oracle AI Vector Search機能は、ドキュメント、画像、その他の非
Oracle AI Vector Searchを使用すると、ビジネス・データにベクトル検索を追加してCohereやChatGPTなどのジェネレーティブAIと組み合わせながら精度の高い分析が可能になります。
<br/>

以下のチュートリアルではAlways Free ADBの作り方から、Oracle AI Vector Searchの様々な使い方を学んでいただける内容になっています。
以下のチュートリアルではAlways Free ADBの作り方/仮想マシンへのOracle Database 23ai Freeのインストール方法から、Oracle AI Vector Searchの様々な使い方を学んでいただける内容になっています。
<br/>

+ **[101 : Always Freeで23aiのADBインスタンスを作成してみよう](/ocitutorials/ai-vector-search/ai-vector101-always-free-adb/){:target="_blank"}**

<!--
+ **[102 : AI Vector Searchを使おう](/ocitutorials/ai-vector-search/ai-vector102-ai-vector-search-basics/){:target="_blank"}**
+ **[103 : File to Embeddingを使おう](/ocitutorials/ai-vector-search/ai-vector103-file-to-embedding/){:target="_blank"}**

+ **[104 : Multi Vector Searchを使おう](/ocitutorials/ai-vector-search/ai-vector104-multi-mector-search/){:target="_blank"}**
<br/>
+ **[102 : 仮想マシンへOracle Database 23ai Freeをインストールしてみよう](/ocitutorials/ai-vector-search/ai-vector102-23aifree-install/){:target="_blank"}**
<!--
+ **[103 : AI Vector Searchを使おう](/ocitutorials/ai-vector-search/ai-vector103-ai-vector-search-basics/){:target="_blank"}**
+
+ **[104 : File to Embeddingを使おう](/ocitutorials/ai-vector-search/ai-vector104-file-to-embedding/){:target="_blank"}**
-->


+ **[105 : Multi Vector Searchを使おう](/ocitutorials/ai-vector-search/ai-vector105-multi-vector-search/){:target="_blank"}**
<br/>





**Database編のチュートリアル一覧に[もどる](/ocitutorials/database/){:target="_blank"}**
<br/>
2 changes: 1 addition & 1 deletion _pages/database.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ OCIであればExadataもサブスクリプションで使えます。インス
# <span style="color: brown; ">■ Oracle AI Vector Searchを使ってみよう</span>

生成AIを拡張するために必要なベクトル検索や顧客や商品に関するビジネス・データを結合する問合せを高性能かつセキュアに実現するOracle AI Vector Search !
Always Free ADBを利用してOracle Database 23ai注目機能のOracle AI Vector Searchを体験してみましょう!
Always Free ADB / Oracle Database 23ai Freeを利用してOracle Database 23ai注目機能のOracle AI Vector Searchを体験してみましょう!


+ **「Oracle AI Vector Search」チュートリアル一覧は[こちら](/ocitutorials/ai-vector-search){:target="_blank"}**
Expand Down
165 changes: 165 additions & 0 deletions tutorials/_ai-vector-search/ai-vector102-23aifree-install.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,165 @@
---
title: "102 : 仮想マシンへOracle Database 23ai Freeをインストールしてみよう"
excerpt: "仮想マシンへOracle Database 23ai Freeをインストールする方法をご紹介します。"
order: "4_102"
layout: single
header:
teaser: "/ai-vector-search/ai-vector102-23aifree-install/ai-vector102-teaser.png"
overlay_image: "/ai-vector-search/ai-vector102-23aifree-install/ai-vector102-teaser.png"
overlay_filter: rgba(34, 66, 55, 0.7)
---

<a id="anchor0"></a>

# はじめに

Oracle Database 23ai Freeは、Oracle Database 23aiを使いやすく、簡単にダウンロードできるようにパッケージ化され、無料で提供されています。Oracle Database 23ai Freeの概要は[こちら](https://www.oracle.com/jp/database/free/)をご参照ください。

Oracle Database 23ai Freeでは、一部リソース制限がありますが、AI Vector Searchの基本的な使い方を体験することができます。

本チュートリアルでは、Oracle Database 23ai Freeを仮想マシンインスタンスへインストールする方法をご紹介します。

<br>

**前提条件 :**
+ Oracle Database 23ai Freeをインストールする仮想マシンインスタンスがプロビジョニング済みであること
<br>※Oracle Cloud Infrastructure上でプロビジョニングする場合は、[入門編-その3 - インスタンスを作成する](/ocitutorials/beginners/creating-compute-instance){:target="_blank"} を参照ください。
<br>[システム要件](https://docs.oracle.com/en/database/oracle/oracle-database/23/xeinl/requirements.html#GUID-427FACD2-F623-4BFA-AB3E-4FE283396547)を満たしていることをご確認ください。
<br>**本チュートリアルはOracle Linux 8を前提にしています。**


**目次**

- [はじめに](#はじめに)
- [1. Oracle Database 23ai Freeのインストール](#1-oracle-database-23ai-freeのインストール)
- [2. Oracle Database 23ai Freeへの接続](#2-oracle-database-23ai-freeへの接続)

<br>

**所要時間 :** 約40分

<a id="anchor1"></a>
<br>

# 1. Oracle Database 23ai Freeのインストール

Oracle Database 23ai Free は、RPM パッケージを使用してインストールできます。

RPM ベースのインストールでは、インストール前のチェック、DBソフトウェアの抽出、抽出したソフトウェアの所有権の事前設定済みユーザーおよびグループへの再割り当て、Oracleイ ンベントリの維持、Oracle Databaseソフトウェアの構成に必要なすべてのroot操作の実行が行われ、シングルインスタンスのOracle Databaseの作成および構成が行われます。

RPM ベースのインストールでは、インストールの最小要件が満たされていない場合、それを検出し、これらの最小プレインストール要件を完了するよう促します。

1. rootでログインします。
```sh
sudo -s
```

1. Oracle Database Preinstallation RPMをインストールします。
```sh
dnf -y install oracle-database-preinstall-23ai
```

Oracle Database Preinstallation RPM は、Oracleインストールの所有者とグループを自動的に作成します。また、Oracle Databaseのインストールに必要なその他のカーネル構成設定も行います。
![image1](image1.png)

1. 以下を実行してOracle Database 23ai FreeのRPM(Oracle Linux 8版)をダウンロードします。
```sh
wget https://download.oracle.com/otn-pub/otn_software/db-free/oracle-database-free-23ai-1.0-1.el8.x86_64.rpm
```

1. DBソフトウェアをインストールします。
```sh
dnf -y install oracle-database-free-23ai-1.0-1.el8.x86_64.rpm
```

![image2](image2.png)

これでOracle Databaseのインストールは完了です。

続いてOracle Databaseの作成と構成を行っていきます。

3. 以下の構成スクリプトを実行して、プラガブル・データベース(FREEPDB1)を1つ持つコンテナ・データベース(FREE)を作成し、デフォルトのポート(1521)でリスナーを構成します。ここの手順は
```sh
/etc/init.d/oracle-free-23ai configure
```

SYS、SYSTEM、PDBADMIN管理ユーザーのパスワードの設定を求められます。Oracleではパスワードは少なくとも8文字以上で、少なくとも1つの大文字、1つの小文字、1桁の数字[0-9]を含むことを推奨しています。

例: Welcome12345#

![image3](image3.png)

1. Oracleユーザーにスイッチし、環境変数を設定します。
```sh
sudo su - oracle
export ORACLE_SID=FREE
export ORAENV_ASK=NO
. /opt/oracle/product/23ai/dbhomeFree/bin/oraenv
```

![image4](image4.png)

<a id="anchor1"></a>
<br>

# 2. Oracle Database 23ai Freeへの接続

1. 以下を実行し、SQL\*Plusでデータベースに接続します。
```sh
sqlplus sys@localhost:1521/freepdb1 as sysdba
```

先ほど設定したSYSのパスワードを入力します。

![image5](image5.png)

1. 表領域を作成します。
```sql
Create bigfile tablespace tbs2 Datafile 'bigtbs_f2.dbf' SIZE 1G AUTOEXTEND ON next 32m maxsize unlimited extent management local segment space management auto;
```

```sql
CREATE UNDO TABLESPACE undots2 DATAFILE 'undotbs_2a.dbf' SIZE 1G AUTOEXTEND ON RETENTION GUARANTEE;
```

```sql
CREATE TEMPORARY TABLESPACE temp_demo TEMPFILE 'temp02.dbf' SIZE 1G reuse AUTOEXTEND ON next 32m maxsize unlimited extent management local uniform size 1m;
```

1. AI Vector Search用のユーザー`VECTOR`を作成します。
```sql
create user vector identified by vector default tablespace tbs2 quota unlimited on tbs2;
```

1. `Vector`に開発者用のロール`DB_DEVELOPER_ROLE`を付与します。
```sql
grant DB_DEVELOPER_ROLE to vector;
```

一度OSに戻ります。
```
exit
```

1. tnsnames.oraにPDB(freepdb1)のサービス名を追加します。
```sh
vi $ORACLE_HOME/network/admin/tnsnames.ora
```

サービス`FREE`のエントリをコピーし、`SERVICE_NAME`**freepdb1**に修正します。

![image6](image6.png)

1. 以下のように`VECTOR`ユーザーでfreepdb1に接続できるようになります。
```sh
sqlplus vector/vector@freepdb1
```

![image7](image7.png)

<br>
以上で、この章は終了です。
次の章にお進みください。

<br>
[ページトップへ戻る](#anchor0)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "102 : Oracle AI Vector Searchを使おう"
title: "103 : Oracle AI Vector Searchを使おう"
excerpt: "Always Free ADBを利用してAI Vector Searchを使う方法について紹介します。"
order: "4_102"
order: "4_103"
layout: single
header:
teaser: "/exadbd/exadb-d101-create-exadb-d/teaser.png"
Expand Down
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: "103 : ファイル→テキスト→チャンク→Embeddingsへの変換およびベクトル検索を使おう"
excerpt: "23ai freeを利用してMulti Vector Searchを使う方法について紹介します。"
order: "4_103"
layout: single
header:
teaser: "/ai-vector-search/ai-vector103-file-to-embedding/teaser.png"
overlay_image: "/ai-vector-search/ai-vector103-file-to-embedding/teaser.png"
overlay_filter: rgba(34, 66, 55, 0.7)
#link: https://apexapps.oracle.com/pls/apex/dbpm/r/livelabs/view-workshop?wid=797
---

---
title: "104 : ファイル→テキスト→チャンク→Embeddingsへの変換およびベクトル検索を使おう"
excerpt: "23ai freeを利用してMulti Vector Searchを使う方法について紹介します。"
order: "4_104"
layout: single
header:
teaser: "/exadbd/exadb-d101-create-exadb-d/teaser.png"
overlay_image: "/exadbd/exadb-d101-create-exadb-d/teaser.png"
overlay_filter: rgba(34, 66, 55, 0.7)
#link: https://apexapps.oracle.com/pls/apex/dbpm/r/livelabs/view-workshop?wid=797
---

# Coming Soon...
15 changes: 0 additions & 15 deletions tutorials/_ai-vector-search/ai-vector104-multi-mector-search.md

This file was deleted.

Loading

0 comments on commit 7c23e20

Please sign in to comment.