データベーステーブル
データベーステーブルモジュールでは、スペース内のすべてのデータベーステーブルアセットを一元管理する機能と、スペースのリソースをまとめて確認・整理する機能を提供しています。
- アセット：データ開発スペースが所有し、全面的に管理します。他の主体（スペース、プロジェクトなど）に権限を付与して、データリソースとして使用させることができます。
- リソース：データ開発スペースで使用できますが、所有権は他の主体にあります。
機能エリアの概要
| 機能エリア | サブ機能 | 説明 |
|---|---|---|
1-機能切り替えエリア | データベース管理 | データベーステーブルモジュールのコア機能で、スペース配下の次のテーブルを確認・管理できます
|
直接接続管理 | この機能エリアでは、次の操作ができます
| |
ゴミ箱 | データベース管理でソフト削除された空間テーブルを回収します
| |
未登録テーブル | データベース管理では、スペースの開発/本番の2つのデータベースにあるテーブルについて、「登録状態」という概念があります：
テーブルが「未登録」になる可能性があるシナリオ
| |
| 2-辞書エリア | 倉庫別に表示 |
|
| 3-タブエリア | タブの表示 |
|
| 4-ページコンテンツエリア | データベース管理ページ | 常駐タブ。データベーステーブルの情報をすばやく検索・確認できます |
| テーブル詳細ページ | メタデータ、フィールド、DDL、データプレビューなど、データベーステーブルの詳細情報を表示します | |
| テーブル作成/テーブル編集ページ | 作成ページで管理モードとテーブルタイプを選択すると、対応する空間テーブルを作成できます | |
| 5-ドロワーエリア | クイックビュー | 管理ページからすばやく呼び出し、テーブルの主要な情報を表示します |
テーブルとビューの作成
データベース管理ページの右上にある「+テーブル」をクリックすると、新規テーブル作成ページに進みます。
スペースのテーブルまたはビューを作成できます。空間テーブルの作成について詳しくは、空間テーブルの章を参照してください
データベース管理
辞書エリア
データベース管理の辞書エリアには、倉庫配下のCatalog - db - tableの構造に沿って、スペース内で利用できるすべてのアセットとリソースが表示されます。
辞書エリアでは、構造ごとにdatabase内のテーブル/ビューの数を集計して表示します。辞書エリアでdatabase名を選択すると、リスト表示エリアにそのdatabase配下のデータベーステーブルが表示されます。
Tips：AEプリセット倉庫で使用できる
- システムテーブルの範囲は、プロジェクト権限付与によって取得する必要があります
- 外部スペースのリソースの範囲は、スペース間のデータ権限付与によって取得する必要があります
辞書エリアの構造は次のとおりです：
| 凡例 | 倉庫 repo | ディレクトリ catalog | 管理モード | データベース db | 説明 |
|---|---|---|---|---|---|
プリセットETL倉庫 | hive | システムテーブル | ta | AEシステムデータベース。ユーザーミラーテーブル、コホート・タグテーブルなどを含みます | |
| ta_dim | AEシステムデータベース。プロジェクトの参照テーブルを含みます | ||||
| ta_ext | AEシステムデータベース。プロジェクトのデータテーブルを含みます | ||||
| temp | AEシステムデータベース。プロジェクトのSQLクエリの一時テーブルを含みます | ||||
| スペース-タスクテーブル | ws_space_${env} | データ開発プラットフォームの2環境のデータベース | |||
| 空間-IDEテーブル | ws_space_ide | データ開発プラットフォームのIDEデータベース | |||
外部空間テーブル | ws_otherspace_product | 外部スペースから本スペースに権限付与された本番環境のデータベース | |||
| ws_otherspace_ide | 外部スペースから本スペースに権限付与されたIDEデータベース |
リスト表示
データベーステーブルのリスト表示エリアでは、次の情報を確認できます：
- データベーステーブルの4要素：倉庫 - Catalog - データベース名 - テーブル名
- データベーステーブルの管理モード
- データベーステーブルの責任者
- データベーステーブルの登録状態
- ドリルダウンしてデータベーステーブルの詳細を確認
- 検索🔍：テーブル名とテーブルのcommentで検索できます
フィルター機能
データベーステーブルのリストページでは、テーブルの主要なフィールドでフィルターできます：
- フィルターパネルはデフォルトで折りたたまれており、展開できます
- フィルター項目をリセットできます
| フィルタータイプ | フィルター項目 | 列挙値 | 説明 |
|---|---|---|---|
チェックボックス | 変更あり | - | 「スペース-タスクテーブル」のみが対象。開発環境と本番環境を比較して変更が発生しているもの |
| 私が担当している | - | 責任者 = 現在ログインしているユーザー | |
| もうすぐ期限切れ | - | ライフサイクルの期限が近づいているデータベーステーブル | |
| 未リリース | - | 開発環境にのみ存在し、まだ本番環境にリリースされていないデータベーステーブル | |
複数選択 | 管理モード |
| スペース内でのテーブルの管理モードで分類 |
テーブルタイプ |
| ||
所属主体 |
| システムテーブルの主体はプロジェクトです 外部空間権限付与テーブルの主体は他のスペースです | |
| 責任者 |
|
|
一括操作機能
データベーステーブルのリストページ（ドリルダウン状態のリストページを含む）では、一括操作ができます。
操作を実行できる対象の範囲は次のとおりです：
| 一括操作機能 | 対応する管理モード | 一括操作の対象範囲 |
|---|---|---|
| 更新 | スペース-タスクテーブル | 登録状態 = 登録済み AND テーブルタイプ = 物理テーブル |
| リリース | スペース-タスクテーブル | 登録状態 = 登録済み AND (リリース状態 = 未リリース OR 変更の有無 = 変更あり) |
| 回収 | スペース-タスクテーブル | 登録状態 = 登録済み（未登録のテーブルはゴミ箱に入れられません）
|
ドロワーエリア
管理ページでテーブルカードをクリックすると、右側にテーブル詳細のドロワーを直接呼び出せます
- 現在のページでテーブルのMetaとフィールド情報をすばやく確認でき、テーブルを探す効率が向上します
- 新しいタブを開かずに呼び出せるため、タブの数を減らせます
表示内容
| エリア | 内容 | 表示される管理モード | 説明 |
|---|---|---|---|
| A | 環境スイッチャー | スペース-タスクテーブル | 開発環境/本番環境のテーブルを切り替えられます |
| B | 未登録の通知 | スペース-タスクテーブル 空間-IDEテーブル | 編集ボタンをクリックしてテーブル編集ページを開き、保存すると登録が完了します |
| C | 倉庫/ディレクトリ/データベース情報 | すべて | その空間テーブルが属するschemaの要素を確認できます |
| D | 管理情報 | すべて | 次の情報を含みます
|
| E | ストレージ方式 | すべて |
|
| F | 責任者 | すべて | システムテーブルはデフォルトで「システム」 |
| 備考 | すべて | ない場合は「-」 | |
| ライフサイクル日数 | スペース-タスクテーブル 空間-IDEテーブル | 未登録テーブルは「-」と表示 | |
| ライフサイクル状態 | すべて | システムテーブル / 外部空間テーブルはデフォルトで「正常」。未登録テーブルは「-」と表示 | |
| G | 作成者 | すべて | システムテーブルはデフォルトで「システム」 |
| 作成日時 | すべて | 空間テーブルの作成時刻 | |
| 最終発行者 | スペース-タスクテーブル | 空間テーブルのリリース情報 | |
| 最終発行時刻 | |||
| H | フィールド情報 | すべて | テーブルのフィールド情報とフィールドのデータタイプ |
| I | DDL | すべて | テーブル作成文（システムテーブルでは表示されません） |
直接接続管理
直接接続は、AEデータ開発プラットフォームの特長的な機能で、企業内部のデータ体系をAEシステムにすばやく移行できます。
直接接続機能は主にTrinoのConnector機能を利用しています。直接接続機能を使うと、AE TrinoにマウントしたカスタムCatalog内のテーブルをベーステーブルとして、ワークスペースで使用できるビュー（View） を作成できます。これらのビューは、開発プラットフォームでは直接接続ビューと呼ばれます。
直接接続ビューはデータ開発プラットフォームのスペースで使用できるほか、アプリケーション - データ権限付与機能を使って、分析エンゲージメントプラットフォームのプロジェクトや他のデータ開発スペースなど、AEシステムの他の主体に権限を付与して使用させることもできます。
直接接続機能を使用するには、まずThinkingAIの担当者に連絡してCatalogを設定してもらう必要があります。
直接接続ビューの一括作成
データベース全体のデータに対して直接接続ビューを作成し、既存のデータ体系をすばやく取り込みたい場合は、直接接続管理ページの右上にある+直接接続ビューをクリックして一括作成できます。作成手順は、直接接続ビューの一括作成の章を参照してください。
また、「直接接続ビュー」はデータ開発プラットフォームにおけるビュー（view）の特殊なタイプです。つまり、ソースのベーステーブルが、trino connectorを介してAEプリセット倉庫に外部マウントされたCatalog内のデータベーステーブルであるビューです。
そのため、単一の「直接接続ビュー」を作成する手順は、通常のビューの作成と同じです。具体的な手順は空間テーブルの章を参照してください。
ゴミ箱
データベーステーブルモジュールの左側ツールバーにある3つ目のアイコンをクリックすると、空間テーブルのゴミ箱リストに進みます。
ゴミ箱の説明：
-
回収された本番/開発環境の空間テーブルを保管します。データは保持されますが、読み書きはできません
-
対応している操作：
- 復元：そのテーブルを再び有効にします
- 完全に削除：データを完全に消去します
-
期限を過ぎても処理されていないテーブル（保管期間が7日を超えたもの）は、システムが自動的にクリーンアップします
-
一括での復元/削除に対応しており、操作の効率が向上します
| カラム名 | 説明 |
|---|---|
| テーブル名 | 空間テーブルのテーブル名。クリックすると、ゴミ箱内の空間テーブルの詳細ページに進みます |
| テーブル説明 | ユーザーが定義したテーブルの説明 |
| タイプ | 空間テーブルのタイプ。テーブルとビューの2種類があり、フィルターできます |
| エンジン構成 | その空間テーブルをクエリできるクエリエンジン。複数のエンジンがある場合があり、フィルターできます |
| 回収理由 | 空間テーブルが回収された理由。期限切れによる回収と手動回収の2種類があり、フィルターできます |
| 回収時間 | 空間テーブルが回収された時刻 |
| 備考 | ユーザー定義の備考です |
| 操作-復元 | クリックすると、その空間テーブルが復元され、引き続き通常どおりアクセスしたり書き込んだりできます |
| 操作-完全に削除 | クリックすると、その空間テーブルが完全に削除されます。完全な削除は取り消せないため、慎重に操作してください |
未登録テーブル
「未登録テーブル」の定義
データベース管理では、スペースの開発/本番の2つのデータベースにあるテーブルについて、「登録状態」という概念があります：
- 登録済み：スペースのデータベーステーブル機能の画面から作成したタスクテーブル
- 未登録：エンジン側には存在する（例：IDEモジュールでcreate tableを実行した）ものの、データベース管理モードで作成されていないテーブル。正常に使用できるよう、不足している情報を補って登録を完了する必要があります。
「未登録テーブル」の管理
スペース内に未登録テーブルがある場合、データベーステーブルの左側ツールバーにある4つ目のTabボタンがハイライト表示され、未登録テーブルの数が表示されます
- 0の場合は表示されません
- 9を超える場合は9+と表示されます
| カラム名 | 説明 |
|---|---|
| テーブル名 | 未登録テーブルのテーブル名 |
| 所属倉庫 | プリセット倉庫 |
| データカタログ | 未登録テーブルが属するデータカタログ |
| データベース | ws_default_${env} は、データ開発プラットフォームの2環境のタスクデータベースです |
| デュアル環境 | 未登録テーブルは、本番環境または開発環境にのみ存在する場合や、両方の環境に存在するものの内容が一致しない場合があります そのため
|
| 関連タスク | タスクフローの中で、現在の未登録テーブルを「目標テーブル」としているタスク |
| 作成日時 | 未登録テーブルが作成された時刻 |
| 操作 |
|
「未登録テーブル」が発生するシナリオ
データ開発プラットフォームのスペース内で、未登録テーブルが発生する可能性がある操作は次のとおりです
| モジュール | 機能エリア | データベース | テーブル/view | 処理 |
|---|---|---|---|---|
| IDE | スクリプト | Hive.本スペースのdevデータベース |
| 「未登録テーブル」に入る |
| Hive.本スペースのproデータベース |
| 「未登録テーブル」に入る | ||
| Hive.本スペースのideデータベース |
| 登録せず、スキャンによる識別も行わない | ||
| 開発 | SQLノード | Hive.本スペースのdevデータベース |
| 「未登録テーブル」に入る |
登録の流れ
ケース1：テーブルが開発環境にのみ存在する
「開発環境に応じて登録」が必要
- 登録完了後、既存のテーブル（開発環境）とデータは保持されます
- 登録完了後、テーブルは「未リリース」状態になります
ケース2：テーブルが本番環境にのみ存在する
- 登録完了後、既存のテーブル（本番環境）とデータは保持され、同じ構造のテーブル（開発環境）が作成されます
- 登録完了後、テーブルは「オンライン」状態になります
ケース3：テーブルが開発環境と本番環境の両方に存在する
-
保持するテーブルを選択する必要があります
-
選択1：開発環境を保持
- 開発環境のテーブルとデータを保持し、本番環境のテーブルとデータを削除します
- 同じ構造の本番環境テーブルを作成します
-
選択2：本番環境を保持
- 本番環境のテーブルとデータを保持し、開発環境のテーブルとデータを削除します
- 同じ構造の開発環境テーブルを作成します
-
登録完了後、テーブルは「オンライン」状態になります