[CDGC] Oracle PL/SQL スクリプトのスキャン

# はじめに
<!-- ★『インフォマティカが提供する、 CDGC (データガバナンスとデータカタログ)を使って』までは定型文 -->
[インフォマティカ](https://www.informatica.com/jp/)が提供する、 [CDGC](https://www.informatica.com/jp/products/data-governance/cloud-data-governance-and-catalog.html) (データガバナンスとデータカタログ)を使って、Oracle PL/SQL スクリプトのカタログソースを設定し、SQL ファイルからメタデータを取得(スキャン)するためのガイドです。
2023/11 時点の情報を元にしています。

カタログソースの表示
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/581c7dba-474f-3bd1-54cb-5bb0b1fc08f0.png)


計算のリネージュ
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/3884470e-7f1f-2c70-7360-be8d40eb8b75.png)

<!-- 各チャプター -->
 
# 事前準備
<!-- ★ここはすべて定型文であり変更は不要 -->
CDGC がセットアップ済みであり、メタデータコマンドセンターのメニューにアクセスできるライセンス、およびユーザロール、ユーザであることを確認してください。[こちらのナレッジベース](https://knowledge.informatica.com/s/article/FAQ-CDGC-apps-licenses-roles?language=ja)より手順をご確認ください。
 
# 前提
<!-- ★ソース側のユーザーや権限、接続前提条件を書く -->
#### メタデータの抽出
以下の権限を割り当てたユーザーを準備します。必要に応じて Oracle 管理者の方とご相談ください。
- スクリプトを格納しているフォルダの読み取り権限
- Oracle データベースへのアクセスに使用するデータベースユーザーアカウントの CONNECT 権限
- 以下のスキーマオブジェクトに対する SELECT 権限
    - 表
    - ビュー
    - プロシージャ―
    - ファンクション
- 次の SELECT 権限
    - select on SYS.DBA_ARGUMENTS
    - select on SYS.DBA_COL_COMMENTS
    - select on SYS.DBA_COLL_TYPES
    - select on SYS.DBA_CONS_COLUMNS
    - select on SYS.DBA_CONSTRAINTS
    - select on SYS.DBA_DB_LINKS
    - select on SYS.DBA_DIRECTORIES
    - select on SYS.DBA_EXTERNAL_LOCATIONS
    - select on SYS.DBA_EXTERNAL_TABLES
    - select on SYS.DBA_MVIEWS
    - select on SYS.DBA_OBJECTS
    - select on SYS.DBA_OPBINDINGS
    - select on SYS.DBA_SEQUENCES
    - select on SYS.DBA_SOURCE
    - select on SYS.DBA_SYNONYMS
    - select on SYS.DBA_TAB_COLUMNS
    - select on SYS.DBA_TAB_COMMENTS
    - select on SYS.DBA_TABLES
    - select on SYS.DBA_TRIGGERS
    - select on SYS.DBA_TYPE_ATTRS
    - select on SYS.DBA_USERS
    - select on SYS.DBA_VIEWS
    - select on SYS.NLS_SESSION_PARAMETERS

# スキャン対象
<!-- ★マニュアルから抜粋し、日本語訳する -->
Oracle から下記のメタデータを取得可能です。
- 計算
- フォルダ
- スクリプト
- ステートメント
 
# 接続設定
<!-- ★先頭1行に関しては定型文、その後はソースに応じて変更する。infoやwarnは検証やKBから記載する -->
CDGC でソースシステムからからメタデータを抽出するには前提にあるようなソース毎の要件を満たしたユーザーで接続を作成する必要があります

:::note info
接続の作成に関しては、[ナレッジベース(KB)](https://knowledge.informatica.com/s/article/How-to-Create-a-connection-for-a-catalog-source-in-CDGC?language=ja) の手順もご確認ください
:::

:::note warn
接続を作成する際に Secure Agent を指定する必要があります。もし、まだインストールされていない方は[ナレッジベース (KB)](https://knowledge.informatica.com/s/article/HOW-To-Install-a-secure-agent-on-a-Linux-machine?language=ja) の手順を参考に Secure Agent をインストールしてください。
:::

以下は、接続の設定例です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/8ad229b7-a650-cea1-ede4-908851760199.png)

# スキャン設定
<!-- ★基本的にはStep by Stepでスクリーンショットを記載する -->
詳細のステップは、[マニュアル](https://docs.informatica.com/data-governance-and-quality-cloud/metadata-command-center/current-version/oracle-pl-sql-script-sources/introduction-to-oracle-pl-sql-script-catalog-sources.html) も合わせて参照してください。
 
1.メニューから「メタデータコマンドセンター」を選択
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/77c2118e-0515-30b3-8bc2-2aba93cc9640.png)
 
2.メタデータコマンドセンターから「新規」を選択
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/9b18ff40-c6cf-4cf7-5316-8f34c13faaaf.png)
 
3.カタログソースから「Oracle PL/SQL スクリプト」を選択
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/c71baf04-783f-33fd-362e-6e71234bb5d9.png)
 
4.Oracle への接続情報を選択し「次へ」をクリックします
必要に応じて、「テスト接続」にて、正常に接続できることを確認してください
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/2af11f9e-5f31-b88e-59bc-9967ee7c8fcf.png)

5.ランタイム接続から利用する Secure Agent を選択、必要に応じてフィルタによる絞り込みを実施します。
スクリプトのルートディレクトリには、スクリプトを配置したディレクトリパスを設定します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/70287343-6fd7-2f10-db7e-3ffa727b6499.png)

6.「関連付け」「スケジュール」は必要に応じて設定しますが、今回はすぐにスキャンを実施したいため、「保存」をクリックし、「実行」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/821bd28c-5ad3-5514-2c23-2074bd2d9c6b.png)

7.実行のスコープの画面で、「実行」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/03551f92-21cc-3ddf-ee11-70b0c2183a7b.png)

8.ジョブ監視画面に自動で遷移するので、しばらく待ってステータスが完了になったことを確認します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/97488adb-0293-b7bd-0c6d-757506f4c3e4.png)

# 結果の確認
<!-- ★CDGC側からの見た目のサンプルを表示。アセット一覧とプロファイリング結果 -->
- 取得したアセットの一覧を表示
CDGC の画面から、該当のカタログリソースが閲覧できることを確認します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3521395/581c7dba-474f-3bd1-54cb-5bb0b1fc08f0.png)


# Tips
<!-- ★KBや経験より記載を実施。今後の予定などがあればそれも記載する -->
- 処理に失敗する場合、[ナレッジベース(KB)](https://knowledge.informatica.com/s/global-search/%20#t=KB&sort=relevancy&f:@athenaproduct=[Cloud%20Data%20Governance%20and%20Catalog])を参照し、エラーメッセージから検索を実施してください。
 
# 参考文献
<!-- ★URLをそれぞれのカタログソースに応じて変更する -->
- [**マニュアル** *ログインが必要](https://www.informatica.com/jp/products/data-governance/cloud-data-governance-and-catalog.html)