Oracle AnalyticsのOCI Visionとの統合

Oracle AnalyticsとVisionの統合の概要

Visionは、Oracle Cloud Infrastructureが提供する複数の人工知能(AI)サービスの1つです。データ・サイエンスの専門知識がなくても、機械学習や人工知能を適用することができます。

Oracle Analytics CloudをVisionと統合すると、Oracle Analytics Cloud内のオブジェクトの検出、イメージの分類およびテキストの検出が可能になります。このAI分析は、Oracle Analytics Cloudのデータ・フローからVisionサービスを呼び出して実行します。

Visionには、事前トレーニング済モデルとカスタム・トレーニング済モデルがあります。

事前トレーニング済モデル

事前トレーニング済モデルにより、ユーザーは汎用データセットに対してイメージ分析タスクを実行できます。

オブジェクト検出は、画像や動画内の現実のオブジェクトや特定のパターンのインスタンスを検出します(たとえば、猫、犬、自転車、航空機など)。
イメージ分類は、固定カテゴリ・セットを使用してイメージにラベルを割り当てます。
テキスト検出は、印刷または手書きのテキストをデジタル形式に変換します。

カスタム・トレーニング済モデル

カスタム・トレーニング済モデルは、特定の目的のために画像およびパターンを検出するように修正および微調整されます。たとえば、事前トレーニング済モデルは電気回路を識別できますが、カスタム・トレーニング済モデルは、電気回路を構成する電気部品(レジスタ、LED、ダイオード、コンデンサなど)を識別するように設計できます。

Oracle AnalyticsとVisionを統合するための一般的なワークフロー

Oracle AnalyticsとVisionを統合し、オブジェクトの検出、イメージの分類またはテキストの検出を実行するには、次のタスクを実行する必要があります。

タスク	説明	詳細情報
前提条件の確認	必要なアクセス権および権限があることを確認します。	どのようなアクセス、権限およびポリシーが必要ですか
OCI Visionへの接続	Visionサービスへの再利用可能な接続を作成します。	OCI Visionサービスへの接続
分析するイメージの準備	分析するソース・イメージのデータセットを作成し、Oracle Analyticsにアップロードします。	Visionモデルを使用した分析用のイメージの準備
Oracle Analyticsでモデルを使用可能にする方法	Oracle AnalyticsにVisionモデルを登録して、データ・フローで使用できるようにします。	Oracle AnalyticsでVisionモデルを使用可能にする方法
イメージの処理	データ・フローを使用して、オブジェクト検出、イメージ分類またはテキスト検出を実行します。	オブジェクト検出、イメージ分類およびテキスト検出分析の実行
結果の分析	データ・フローによって生成されたデータセットを使用して、結果を分析します。	オブジェクト検出、イメージ分類およびテキスト検出分析モデル用に生成された出力データ

どのようなアクセス、権限およびポリシーが必要ですか

Oracle AnalyticsをOCI Visionと統合するために必要なアクセス、権限およびポリシーは次のとおりです。

お客様(またはOracle Analytics CloudからVisionサービスへの接続を計画しているユーザー)が、Visionの統合プロセスに使用されるコンパートメントおよびリソースへのアクセスに必要なポリシーを付与されたグループに属していることを確認してください。これらのポリシーが最低限必要です。

OCIテナンシにOracle Analyticsから接続する場合は、OCI APIキーまたはリソース・プリンシパルを使用できます。

表26-1 OCI Vision統合に必要なセキュリティ・ポリシー

APIキー・ポリシー	リソース・プリンシパル・ポリシー
グループ<group_name>にテナンシのai-service-vision-familyの管理を許可します	すべてのユーザーにすべての{request.principal.id='<analytics_instance_ocid>'}のテナンシのai-service-vision-familyの管理を許可します
グループ<group_name>にコンパートメント<compartment_name>のバケットの読取りを許可します	すべてのユーザーにすべての{request.principal.id='<analytics_instance_ocid>'}のコンパートメント<compartment_name>のバケットの読取りを許可します
グループ<group_name>にtarget.bucket.name='<staging_bucket_name>'のコンパートメント<compartment_name>のオブジェクトの管理を許可します	すべてのユーザーに{request.principal.id='<analytics_instance_ocid>'、target.bucket.name='<staging_bucket_name>'}のコンパートメント<compartment_name>のオブジェクトの管理を許可します
グループ<group_name>にtarget.bucket.name='<images_bucket_name>'のコンパートメント<compartment_name>のオブジェクトの読取りを許可します	すべてのユーザーにすべての{request.principal.id='<analytics_instance_ocid>'、target.bucket.name='<images_bucket_name>'}のコンパートメント<compartment_name>のオブジェクトの読取りを許可します
グループ<group_name>に、テナンシのobjectstorage-namespacesの読取りを許可します	すべてのユーザーにすべての{request.principal.id='<analytics_instance_ocid>'}のテナンシのobjectstorage-namespacesの読取りを許可します

ノート(リソース・プリンシパル・ポリシーの場合): または、{request.principal.id='<analytics_instance_ocid>'}のかわりに{request.principal.type='analyticsinstance'、request.principal.compartment.id='<compartmentA_ocid>'}を使用できます。これには、compartmentAの下にすべてのアナリティクス・インスタンスが含まれます。

OCI Visionサービスへの接続

Oracle AnalyticsでVisionサービスへの接続を作成し、Visionモデルを使用してイメージを分析できるようにします。

OCIコンソールで、OCIテナンシ・プロファイルに移動し、リージョン、テナンシOCIDおよびユーザーOCIDをコピーします。
- リージョンについては、プロファイルの上部に表示されている地理的リージョンを確認してください。
- テナンシOCIDについては、「テナンシ」の名前をクリックし、OCIDをコピーします。
- ユーザーOCIDについては、「ユーザー設定」をクリックし、OCIDをコピーします。
図vision_tenancy_ids.pngの説明
Oracle Analyticsホーム・ページで、「作成」をクリックしてから、「接続」をクリックします。
「OCIリソース」をクリックします。
「接続名」で、Oracle Analytics内の接続の詳細を識別するためのわかりやすい名前を指定します。
「リージョン識別子」で、ステップ1でコピーしたリージョンを選択します。
「テナンシOCID」で、ステップ1でコピーしたテナンシOCIDを貼り付けます。
「ユーザーOCID」で、ステップ1でコピーしたユーザーOCIDを貼り付けます。
「APIキー」で、「生成」をクリックし、「コピー」をクリックします。
OCIコンソールで、「ユーザー設定」に移動し、「APIキーの追加」をクリックします。
「公開キー」で、ステップ8でOracle Analyticsからコピーしたキーを貼り付け、「追加」をクリックします。
Oracle Analyticsの「接続の作成」ダイアログで、「保存」をクリックします。

Visionモデルを使用した分析用のイメージの準備

OCIオブジェクト・ストレージのバケットを使用して、分析するイメージを格納し、Oracle Analyticsでこれらのイメージにアクセスするためのデータセットを作成します。

ほとんどの場合、入力イメージとVisionモデルは同じOracle Cloudアカウント(テナンシ)に格納されます。入力イメージとVisionモデルが異なるテナンシに格納されている場合、入力イメージを含むストレージ・バケットの可視性が「パブリック」であり、データ・フローの入力データセットが個々のイメージURLを含むことを確認する必要があります(ステップ4を参照)。バケットをパブリックにする方法については、バケットの表示の変更を参照してください。

Oracle Analyticsのデータ・フローは、1回の実行で最大20,000のイメージを処理できます。処理するイメージが20,000を超える場合は、複数のバケットを作成し、各バケットが20,000を超えないイメージで構成されるようにします。次に、バケットごとに個別のデータセットおよびデータ・フローを作成し、シーケンスを使用して複数のデータ・フローを順番に処理します。

OCIコンソールで、「オブジェクト・ストレージとアーカイブ・ストレージ」に移動し、イメージを格納するための新しいバケットを作成します。

図vision_bucket_nav.pngの説明
イメージをバケットにアップロードします。
バケットに無関係なファイルが含まれていないことを確認します。Oracle Analyticsは、バケット内のすべてのファイルを処理します。

図vision_bucket_obj_dets.pngの説明

バケットはプライベートでもパブリックでもかまいませんが、OCIユーザーがアクセスでき、イメージに関するOCIの一般的な制限事項に準拠している必要があります。OCIのドキュメントを参照してください。
バケット内のすべてのイメージを処理するには、バケットURLをCSVファイルに追加します。
1. オブジェクト・ストレージで、バケットを選択して、「オブジェクト」ダイアログにイメージを表示します。
2. ブラウザのURLバーからURLをコピーします。
3. ID、Bucket NameおよびBucket URLのフィールドを含むCSVファイルを作成します。
4. バケットURLをBucket URLの値としてCSVファイルに貼り付けます。
  
  図vision_create_dataset2.pngの説明
イメージを個別に処理するには、イメージURIをCSVファイルに追加します。
1. ID、Image NameおよびFile Locationのフィールドを含むCSVファイルを作成します。
2. オブジェクト・ストレージ内の各イメージについて、省略アイコンをクリックし、「オブジェクト詳細の表示」を選択します。
3. 「名前」の値および「URLパス(URI)」の値をコピーします。
4. 「名前」の値をImage Nameに貼り付け、「URLパス(URI)」値をFile Locationに貼り付けます。
  
  図vision_create_dataset.pngの説明
Oracle Analyticsで、「作成」、「データセット」をクリックします。
ステップ3またはステップ4で作成したCSVファイルをアップロードし、データセットを保存します。

イメージが20,000を超える場合は、通常、最大20,000イメージで構成される複数のバケットを作成し、バケットごとに個別のデータセットを作成します。

Oracle AnalyticsでVisionモデルを使用可能にする方法

Oracle AnalyticsでVisionモデルを使用可能にすると、データ・フローを使用して、オブジェクトの検出、イメージの分類またはテキストの検出を実行できるようになります。

OCIオブジェクト・ストレージで、適切な名前(たとえば、MyVisionModelStagingBucket)を使用して、コンパートメントにバケットを作成します。
このステージング・バケットは:
- アクセス可能なコンパートメントに作成する必要があります。
- モデルを登録する前に作成する必要があります。
- プライベート可視性を設定できます。
- 複数のモデルに使用できます。
- 「検査」画面で変更できます。
Oracle Analyticsホーム・ページで、「ページ・メニュー」をクリックし、「モデル/関数の登録」、OCI Visionモデルの順に選択します。
「Visionモデルの登録」ダイアログで、「接続から」の下にある、「Visionサービスへの接続」で作成した接続をクリックします。

図register-vision-model.pngの説明

使用可能なモデルのリストが表示されます。

図vision_models.pngの説明
使用可能なモデルのリストで、イメージ・データに適用するモデルをクリックします。
たとえば、写真に写っている車を検出するには、事前トレーニング済オブジェクト検出を選択します。モデルの詳細を表示する情報パネルがポップアップ表示されます。

図vision_models_2.pngの説明
「モデル名」で、Oracle Analytics内のモデルを識別するための名前を指定します。
「ステージング・バケット名」に、ステップ1で指定した名前(たとえば、MyVisionModelStagingBucket)を入力します。
「登録」をクリックします。

登録されているモデルを確認するには、Oracle Analyticsホーム・ページから、「機械学習」、「モデル」の順に移動します。