DA# Macro(5): 使用上の注意/注意事項、ダウンロード、今後追加予定機能、お知らせ
この記事では、DA# Macroの使用上の注意/注意事項、ダウンロード、今後の追加予定機能、展開について説明します。
前の記事で続く内容だ。
DA# Macro(4): DA# Macro(マクロ)機能(3)-Reverse
3. DA# Macro 使用上の注意事項／注意事項
3.1。 DA# Macro 使用上の注意事項
- Entity / AttributeのSet Macroを実行する前に、ターゲットDA# v5モデルファイルのバックアップをお勧めします。
- メモリ不足エラー防止と性能向上のため、Macro内でUndoを無効にするためだ。
- UDP項目は、対応するモデルに事前に作成されている必要があります。現在配布されているDA# Macro Version（v2.12）ではUDPエントリを生成しません。 UDP名を誤って入力し、Macroを実行して誤ったUDPが生成される問題を防止するためです。 （今後のバージョンで実装予定）
- UDP項目は追加/削除/順序変更追加/削除/順序変更可能ですが、基本項目は追加/削除/順序変更禁止です。
3.2。 DA# Macro ノート
3.2.1. Reverseの同時実行方法
Reverse機能は入力ファイルで指定された複数のモデルを順次処理できますが、時間が長すぎる場合はモデル別にファイルを分けて同時に処理することができます。
ファイルを分割するときは、「モデル」シートにのみターゲットモデルを残してください。 「Table」、「Column」、「FK」シートにモデル全体の情報がある場合でも、「Model」シートに基づいてReverseを実行します。
あるPCで同時に処理するには、Excel instanceを複数実行し、各instanceで処理するモデルファイルを指定して実行すればよい。
（注： ネイバー国語辞典/英語辞書検索ツールの概要 - 3.2。複数のExcel processを実行する方法)
しかし、あるPCで同時に処理する方法は、CPUリソース競合で期待したものよりも早く処理されない。複数のPCに分けて実行すれば同時に迅速に処理できる。
3.2.2。 DA# Macroが正常に動作しない場合の対処
次のような現象が発生した場合の対策方法である。
- 現象
- 作業管理者で確認してみたとき、DA# v5(Modeler5.exe)が実行されていて(Instance #1)、モデルを一つ開いている状態で、
- DA# Macroで「オープンモデルの追加」ボタンをクリックすると、Modeler5.exeプロセスが新しく作成されて（Instance #2）「オープンモデルがありません」というメッセージが出力され、
- 既存のInstance #1で開いているモデル情報を取得できない現象
- 原因
- DA#のインストール時にRegistryに情報を正しく反映できない場合に発生します。
- この現象が発生すると、DA#の使用には何の問題もありませんが、APIでDA#を実行しても正常に動作しません。
- 対策方法
- コマンドプロンプトを管理者モードで実行（重要!!!）次のコマンドを入力してDA# v5オブジェクトを再登録します。
- DA#がデフォルトパスとは異なるパスにインストールされている場合は、そのパスに移動して「RegisterServer.bat」コマンドを実行します。
cd "C:\Program Files (x86)\ENCORE\DATAWARE_DA5\DA Modeler" RegisterServer.bat
上記の命令を実行した後、DA# Macroを再実行して異常現象が解決したか確認してください。
3.2.3。 Reverse情報収集SQL（Oracle用）
Oracle DatabaseでReverseに必要なTable、Column、FKのリストを収集するSQL例です。
このSQLを実行するには、「SELECT ANY DICTIONARY」権限が必要です。
-- TABLE 목록
SELECT ROW_NUMBER() OVER(ORDER BY A.OWNER, A.TABLE_NAME) AS RNO
,'모델1' AS 모델명, '주제영역1' AS 주제영역명, '그룹1' AS 엔터티그룹명
,CASE
WHEN INSTR(T.COMMENTS, CHR(10)) > 0 THEN A.TABLE_NAME -- COMMENT에 행분리 문자가 있는 경우 엔터티명 부적합하여 테이블명으로 사용
WHEN T.COMMENTS IS NOT NULL THEN T.COMMENTS
ELSE A.TABLE_NAME
END AS 엔터티명
,A.TABLE_NAME AS 테이블명
,TRIM(TO_CHAR(A.NUM_ROWS, '9,999,999,999,999')) AS 동의어 -- 동의어에 총건수를 문자형으로 추출(comma 포함)
,A.TABLE_NAME AS 보조명
,A.OWNER AS DBOWNER
,NULL AS 분류, NULL AS "LEVEL", NULL AS 단계, NULL AS 유형, NULL AS 표준화, NULL AS 상태, NULL AS 발생주기, NULL AS 월간발생량, NULL AS "보존기한(월)"
,A.NUM_ROWS 총건수
,T.COMMENTS AS 정의
,NULL AS 데이터처리형태, NULL AS 특이사항, NULL AS Note, NULL AS TAG
,O.CREATED, O.LAST_DDL_TIME, A.LAST_ANALYZED, A.TEMPORARY
,'[COMMENT]: ' || T.COMMENTS || CHR(13) || CHR(10) ||
'[NUM_ROWS]: ' || TRIM(TO_CHAR(A.NUM_ROWS, '9,999,999,999,999')) || CHR(13) || CHR(10) ||
'[CREATED]: ' || TO_CHAR(O.CREATED, 'YYYY-MM-DD HH24:MI:SS') || CHR(13) || CHR(10) ||
'[LAST_DDL_TIME]: ' || TO_CHAR(O.LAST_DDL_TIME, 'YYYY-MM-DD HH24:MI:SS') || CHR(13) || CHR(10) ||
'[LAST_ANALYZED]: ' || TO_CHAR(A.LAST_ANALYZED, 'YYYY-MM-DD HH24:MI:SS') AS 정의2
FROM DBA_TABLES A INNER JOIN DBA_OBJECTS O
ON ( A.OWNER = O.OWNER
AND A.TABLE_NAME = O.OBJECT_NAME
AND O.OBJECT_TYPE = 'TABLE')
LEFT OUTER JOIN DBA_TAB_COMMENTS T
ON ( A.OWNER = T.OWNER
AND A.TABLE_NAME = T.TABLE_NAME )
WHERE 1=1
AND A.TABLE_NAME NOT LIKE 'BIN$%'
AND A.OWNER IN ('OWNER1', 'OWNER2') -- 해당 OWNER 지정
-- AND A.TABLE_NAME = 'TABLE_NAME' -- 특정 TABLE만 포함 또는 제외
ORDER BY A.OWNER, A.TABLE_NAME
;
-- COLUMN 목록
WITH WC AS (
SELECT A.OWNER, A.TABLE_NAME, A.COLUMN_NAME, A.COLUMN_ID, A.DATA_TYPE
,CASE WHEN A.DATA_TYPE= 'NUMBER' AND A.DATA_SCALE > 0 THEN A.DATA_PRECISION||','||A.DATA_SCALE
WHEN A.DATA_TYPE= 'NUMBER' AND A.DATA_SCALE = 0 THEN TO_CHAR(A.DATA_PRECISION)
WHEN A.DATA_TYPE= 'NUMBER' AND A.DATA_SCALE IS NULL THEN ''
WHEN A.DATA_TYPE IN ('DATE','TIMESTAMP','BLOB', 'CLOB') THEN NULL
WHEN A.DATA_TYPE LIKE 'TIMESTAMP%' THEN NULL
ELSE TO_CHAR(A.DATA_LENGTH)
END AS DATA_LENGTH
,A.DATA_PRECISION, A.DATA_SCALE
,DECODE(A.NULLABLE, 'Y','N','Y') AS NOT_NULL
,DECODE(B.COLUMN_NAME, NULL, 'N', 'Y') PRI_KEY
,B.POSITION PK_POSITION
,T.COMMENTS
,A.DEFAULT_LENGTH
-- ,A.DATA_DEFAULT
,CASE
WHEN A.DEFAULT_LENGTH IS NULL THEN NULL
ELSE EXTRACTVALUE
( DBMS_XMLGEN.GETXMLTYPE
( 'SELECT DATA_DEFAULT FROM DBA_TAB_COLUMNS WHERE OWNER = ''' || A.OWNER || ''' AND TABLE_NAME = ''' || A.TABLE_NAME || ''' AND COLUMN_NAME = ''' || A.COLUMN_NAME || '''' )
, '//text()' )
END AS DATA_DEFAULT
,A.LAST_ANALYZED, A.NUM_DISTINCT
-- ,A.LOW_VALUE
,DECODE(DATA_TYPE
,'NUMBER' ,TO_CHAR(UTL_RAW.CAST_TO_NUMBER(LOW_VALUE))
,'VARCHAR2' ,TO_SINGLE_BYTE(UTL_RAW.CAST_TO_VARCHAR2(LOW_VALUE))
,'CHAR' ,TO_SINGLE_BYTE(UTL_RAW.CAST_TO_VARCHAR2(LOW_VALUE))
,'NVARCHAR2' ,TO_CHAR(UTL_RAW.CAST_TO_NVARCHAR2(LOW_VALUE))
,'BINARY_DOUBLE',TO_CHAR(UTL_RAW.CAST_TO_BINARY_DOUBLE(LOW_VALUE))
,'BINARY_FLOAT' ,TO_CHAR(UTL_RAW.CAST_TO_BINARY_FLOAT(LOW_VALUE))
,'DATE',DECODE(LOW_VALUE, NULL, NULL, TO_CHAR(1780+TO_NUMBER(SUBSTR(LOW_VALUE,1,2),'XX')
+TO_NUMBER(SUBSTR(LOW_VALUE,3,2),'XX'))||'-'
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(LOW_VALUE,5,2), 'XX'), '00'))||'-'
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(LOW_VALUE,7,2), 'XX'), '00'))||' '
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(LOW_VALUE,9,2),'XX')-1, '00'))||':'
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(LOW_VALUE,11,2),'XX')-1, '00'))||':'
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(LOW_VALUE,13,2),'XX')-1, '00')))
,LOW_VALUE
) LOW_VALUE
-- ,A.HIGH_VALUE
,DECODE(DATA_TYPE
,'NUMBER' ,TO_CHAR(UTL_RAW.CAST_TO_NUMBER(HIGH_VALUE))
,'VARCHAR2' ,TO_SINGLE_BYTE(UTL_RAW.CAST_TO_VARCHAR2(HIGH_VALUE))
,'CHAR' ,TO_SINGLE_BYTE(UTL_RAW.CAST_TO_VARCHAR2(HIGH_VALUE))
,'NVARCHAR2' ,TO_CHAR(UTL_RAW.CAST_TO_NVARCHAR2(HIGH_VALUE))
,'BINARY_DOUBLE',TO_CHAR(UTL_RAW.CAST_TO_BINARY_DOUBLE(HIGH_VALUE))
,'BINARY_FLOAT' ,TO_CHAR(UTL_RAW.CAST_TO_BINARY_FLOAT(HIGH_VALUE))
,'DATE',DECODE(HIGH_VALUE, NULL, NULL, TO_CHAR(1780+TO_NUMBER(SUBSTR(HIGH_VALUE,1,2),'XX')
+TO_NUMBER(SUBSTR(HIGH_VALUE,3,2),'XX'))||'-'
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(HIGH_VALUE,5,2), 'XX'), '00'))||'-'
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(HIGH_VALUE,7,2), 'XX'), '00'))||' '
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(HIGH_VALUE,9,2),'XX')-1, '00'))||':'
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(HIGH_VALUE,11,2),'XX')-1, '00'))||':'
||TRIM(TO_CHAR(TO_NUMBER(SUBSTR(HIGH_VALUE,13,2),'XX')-1, '00')))
,HIGH_VALUE
) HIGH_VALUE
,TB.NUM_ROWS, A.NUM_NULLS, A.CHAR_USED, A.AVG_COL_LEN
FROM DBA_TABLES TB LEFT OUTER JOIN DBA_TAB_COLUMNS A
ON (TB.OWNER = A.OWNER
AND TB.TABLE_NAME = A.TABLE_NAME)
LEFT OUTER JOIN
(SELECT C.OWNER, C.TABLE_NAME, C.COLUMN_NAME, C.POSITION
FROM DBA_CONS_COLUMNS C INNER JOIN DBA_CONSTRAINTS S
ON ( C.OWNER = S.OWNER
AND C.TABLE_NAME = S.TABLE_NAME
AND C.CONSTRAINT_NAME = S.CONSTRAINT_NAME )
WHERE S.CONSTRAINT_TYPE = 'P'
) B
ON ( A.OWNER = B.OWNER
AND A.TABLE_NAME = B.TABLE_NAME
AND A.COLUMN_NAME = B.COLUMN_NAME )
LEFT OUTER JOIN ALL_COL_COMMENTS T
ON ( T.OWNER = A.OWNER
AND T.TABLE_NAME = A.TABLE_NAME
AND T.COLUMN_NAME = A.COLUMN_NAME )
WHERE 1=1
AND A.OWNER IN ('OWNER1', 'OWNER2') -- 해당 OWNER 지정
AND A.TABLE_NAME NOT LIKE 'BIN$%'
AND NOT EXISTS ( SELECT 'X' -- View column 제외 조건
FROM DBA_VIEWS V
WHERE V.OWNER = A.OWNER
AND V.VIEW_NAME = A.TABLE_NAME )
--AND A.TABLE_NAME = 'TABLE_NAME'
-- ORDER BY OWNER, TABLE_NAME, COLUMN_ID
)
SELECT ROW_NUMBER() OVER(ORDER BY OWNER, TABLE_NAME, COLUMN_ID) AS RNO
-- ,ROW_NUMBER() OVER(PARTITION BY OWNER, TABLE_NAME ORDER BY COLUMN_ID) AS COLNO
,'모델1' AS 모델명
,'' AS 엔터티명
,CASE
WHEN INSTR(COMMENTS, CHR(10)) > 0 THEN COLUMN_NAME -- COMMENT에 행분리 문자가 있는 경우 속성명 부적합하여 컬럼명으로 사용
WHEN COMMENTS IS NOT NULL THEN COMMENTS
ELSE COLUMN_NAME
END AS 속성명
,TABLE_NAME AS 테이블명
,COLUMN_NAME AS 컬럼명
,COMMENTS AS 정의
,COLUMN_NAME AS 보조명
,COLUMN_NAME AS 동의어
,TABLE_NAME AS Reverse테이블명
,COLUMN_NAME AS Reverse컬럼명
,DATA_TYPE AS ReverseType
,DATA_LENGTH AS ReverseLENGTH
,PRI_KEY AS PK
,NOT_NULL AS NOTNULL
,NULL AS 유형
,DATA_TYPE AS 데이터타입
,DATA_PRECISION AS 길이
,DATA_SCALE AS 소수점
,DATA_DEFAULT AS 기본값
,NULL AS 기본값, NULL AS 도메인, NULL AS "FK", NULL AS 핵심속성여부, NULL AS 본질식별자여부
,NULL AS 보조식별자여부, NULL AS 표준동기화여부, NULL AS 비상속여부, NULL AS 표준화
,NULL AS 정보보호여부, NULL AS 정보보호등급, NULL AS 암호화여부, NULL AS 스크램블
,'[COMMENT]: ' || COMMENTS || CHR(13) || CHR(10) ||
'[NUM_ROWS]: ' || TRIM(TO_CHAR(NUM_ROWS, '9,999,999,999,999')) || CHR(13) || CHR(10) ||
'[NUM_DISTINCT]: ' || TRIM(TO_CHAR(NUM_DISTINCT, '9,999,999,999,999')) || CHR(13) || CHR(10) ||
'[NUM_NULLS]: ' || TRIM(TO_CHAR(NUM_NULLS, '9,999,999,999,999')) || CHR(13) || CHR(10) ||
'[NULL%] : ' || DECODE(NVL(NUM_ROWS, 0), 0, 0, ROUND(NUM_NULLS / NUM_ROWS, 5) * 100) || '%' || CHR(13) || CHR(10) ||
'[MIN_VALUE]: ' || LOW_VALUE || CHR(13) || CHR(10) ||
'[MAX_VALUE]: ' || HIGH_VALUE AS 정의2
-- ,WC.*
FROM WC
WHERE NUM_NULLS > 0
ORDER BY OWNER, TABLE_NAME, COLUMN_ID
;
-- FK 목록
WITH WFK AS (
SELECT DISTINCT
C2.OWNER AS P_OWNER
,C2.TABLE_NAME P_TABLE_NAME
,LISTAGG (C2.COLUMN_NAME, ',') WITHIN GROUP (ORDER BY C2.POSITION)
OVER ( PARTITION BY C1.OWNER, C1.TABLE_NAME, C1.CONSTRAINT_NAME, C2.OWNER, C2.TABLE_NAME) AS P_COLUMN_LIST
,C1.OWNER AS C_OWNER
,C1.TABLE_NAME AS C_TABLE_NAME
,C1.CONSTRAINT_NAME AS C_CONSTRAINT_NAME
FROM DBA_CONSTRAINTS C1 INNER JOIN DBA_CONS_COLUMNS C2
ON (C1.R_CONSTRAINT_NAME = C2.CONSTRAINT_NAME
AND C1.R_OWNER = C2.OWNER)
WHERE C1.OWNER IN ('OWNER1', 'OWNER2') -- 해당 DB의 테이블 OWNER 지정
AND C1.CONSTRAINT_TYPE = 'R'
ORDER BY C2.OWNER, C2.TABLE_NAME
)
SELECT '모델1' AS 모델명
,P_TABLE_NAME AS 부모엔터티명
,P_TABLE_NAME AS 부모테이블명
,C_TABLE_NAME AS 자식엔터티명
,C_TABLE_NAME AS 자식테이블명
,P_TABLE_NAME || '->' || C_TABLE_NAME AS 관계명
,NULL AS 정의, NULL AS 관계유형, NULL AS 기수성, NULL AS 선택성, NULL AS 식별성
,NULL AS 부모엔터티관계동사, NULL AS 자식엔터티관계동사
FROM WFK
;
上記のSQLを使用する場合は、次の内容を参照してください。
- 対象Owner（Schema）を確認して修正する。 (32、116、179行)
- Tableの定義をCommentで指定（15行）するか、複数のcolumnを集合した値で指定（18～22行）するかを選択する。
- Columnの定義には、Oracleの統計情報を活用して次の情報を含むように抽出する。
- COMMENT: Column coment
- NUM_ROWS: Table Row count
- NUM_DISTINCT：重複を削除した値の数
- NUM_NULLS：その列の値がNULLのRow count
- NULL%: (NUM_NULLS / NUM_ROWS) * 100 で計算された合計 Row のうち Null である Row の割合
- MIN_VALUE：その列の最小値（DBA_TAB_COLUMNS.LOW_VALUEからDATA_TYPEに基づいて抽出）
- MAX_VALUE：その列の最大値（DBA_TAB_COLUMNS.HIGH_VALUEからDATA_TYPEに基づいて抽出）
- ColumnのMIN_VALUE、MAX_VALUEは以下の内容を参照する。 （63～78、80～95行）
- ORA-29275: partial multibyte character(部分マルチバイト文字)エラーが発生した場合、to_single_byte関数を適用してみて、それでもエラーが発生した場合は最大、最小値を除いて抽出する。
- 最大、最小値を除いて抽出する場合、Column定義内容(158、159行)も一緒に修正する。
- SQLを実行できるアカウント、接続情報、権限を得るまでに時間がかかるか不可能な場合は、DBAまたはIT運営者に該当SQLを渡し、実行結果をExcelファイルとして保存して返信を要請する。
- ３つのＳＱＬを実行した結果は、３つのファイル（各ファイルにシート１つ）としてもよいし、１つのファイル（シート３つ）としてもよい。
4. DA# Macroダウンロード、今後の追加予定機能、展開
4.1。 DA# Macro ダウンロード
以下のgithubリポジトリで確認できます。
https://github.com/DAToolset/DA-Macro
あるいは、このURLから直接ダウンロードできます。
https://github.com/DAToolset/DA-Macro/raw/main/DA%23%20Macro_v2.12_20210814.xlsm
4.2。 DA# Macro 今後追加予定機能
DA# Macroは、現在実装されている機能に加えて、次の機能を追加する予定です。
- Subtype プロパティ Get/Set: Subtype 内で管理されるプロパティ Get/Set (階層プロパティを含む)
- AR モデル Get/Set: AR モデルを Treeview として照会し、複数のモデルを選択して Get/Set
- Relationship Get/Set: エンティティ間 Relationship Get/Set
- エンティティ配置方法の拡張
4.3。ユーザーを置く
バグ、機能改善、追加機能などの要件は、ブログコメントまたは電子メールで送信してください。ただし、このツールはあくまで趣味で開発しているため、要求事項への迅速な対応はできない。余裕時間があるとき、該当機能が必要なときに反映して配布する。配布サイクルも規則的ではありません。
ソースコードを一緒に提供するので、必要な機能があれば反映し、また私に共有してくれれば大変感謝します。
これまでDA# Macroの使用方法についてすべて調べてみた。次に、DA# Macroのソースコードを見てみましょう。
<< 関連記事のリスト >>
- DA# Macro(1): DA#, DA# API, DA# Macro (マクロ)の概要
- DA# Macro(2): DA# Macro(マクロ)機能(1)-共通機能, Entity Get/Set
- DA# Macro(3): DA# Macro(マクロ)機能(2)-Attribute Get/Set
- DA# Macro(4): DA# Macro(マクロ)機能(3)-Reverse
- DA# Macro(5): 使用上の注意/注意事項、ダウンロード、今後追加予定機能、お知らせ
- DA# Macro(6): DA# Modeler API
- DA# Macro機能デモ映像(YouTube)
- DA# Macro 説明文 目次 , ダウンロード
関連記事：
データ標準チェックツール_3.標準チェックケース別結果
データ標準チェックツール_2.3.データ標準事前設定
DA# Macro機能デモ映像(YouTube)
DA# Macro(6): DA# Modeler API
DA# Macro(4): DA# Macro(マクロ)機能(3)-Reverse
DA# Macro(3): DA# Macro(マクロ)機能(2)-Attribute Get/Set
DA# Macro(2): DA# Macro(マクロ)機能(1)-共通機能, Entity Get/Set
DA# Macro(1): DA#, DA# API, DA# Macro (マクロ)の概要
日本語 
한국어 
English 
简体中文 
Deutsch 
Español