データベースライブラリの操作

Altium Designer では、Database Library を作成して使用することで、会社のデータベースからコンポーネントを直接配置できます。配置は Components panel から行い、データベースライブラリをインストールすると、このパネルがデータベースを参照するブラウザとして機能します。

配置後、Tools » Update Parameters From Database コマンドを使用して、配置済みコンポーネントとデータベース内の対応するリンク済みレコード間で設計パラメータ情報を同期できます。グラフィカルシンボル、モデル参照、パラメータを含むコンポーネントの完全更新は、Tools » Update From Libraries コマンドで実行できます。データベースのパラメトリック情報は最終的な部品表（BOM）にも含められるため、部品調達にそのまま利用できます。

Direct Placement - Beyond Mere Linking

Altium Designer では、コンポーネントからデータベースへリンクする方法として、Database Link ファイル（*.DbLink）、Database Library ファイル（*.DbLib）、SVN Database Library ファイル（*.SVNDbLib）をそれぞれ使用する 3 つの方法が用意されています。DbLink アプローチは、設計（またはライブラリ）で使用しているコンポーネントを、データベースに入力されたデータと効率よくリンクし、同期を保つための手段を提供します。DbLib/SVNDbLib アプローチは、この実績あるリンク効率に加えて、データベースからコンポーネントを直接配置できる自由度を追加します。つまり、対応するデータベースレコードに保存された情報から、実質的にコンポーネントを動的に生成します。

データベースライブラリ機能をより深く扱う前に、これらの方法の違いを、使い方の観点から整理しておくとよいでしょう。

Linking using a Database Link file

Related page: Linking Existing Components to Your Company Database

• この方法では、Database Link ファイル（*.DbLink）が、回路図コンポーネントとデータベース内の一致するレコードとのリンクを定義します。レコードの一致はキー・フィールドのリンクによって確立され、単一のキー・フィールド（例：品番）でも、複数のキー・フィールド（Where 句を定義）でも構いません。
• このリンク方法では、コンポーネントのモデルおよびパラメータ情報は、Altium Designer のライブラリコンポーネントの一部として事前に定義しておく必要があります。また、ライブラリコンポーネントの定義には必要なキー・フィールド情報も含める必要があります。これを定義したら、Database Link ファイルを Library Package または Design プロジェクトに追加し、コンポーネント情報（パラメータ）をデータベースのフィールド内容と同期できます。
• 各データベースレコードで定義される物理コンポーネントが、必ずしも一意の Altium Designer ライブラリコンポーネントに対応する必要はありません（多くのデータベースコンポーネントが同一のコンポーネントシンボルを共有可能です）が、このリンク方法は通常、「1 つのデータベースレコード対 1 つの Altium Designer コンポーネント」という形で使用されます。一意の Altium Designer コンポーネントは、回路図シート上に配置されたインスタンスでも、コンポーネントライブラリ内の一意コンポーネントでも構いません。
• DbLink 形式のデータベースリンクでは、Database Link ファイルをライブラリパッケージ、または設計プロジェクトに含めます。

Linking using a Database Library file

• この方法では、Database Library ファイル（*.DbLib）も、回路図コンポーネントとデータベース内の一致するレコードとのリンクを定義します。ここでも、レコードの一致はキー・フィールドのリンクによって確立され、単一のキー・フィールド（例：品番）でも、複数のキー・フィールド（Where 句を定義）でも構いません。
• このリンク方法の重要な違いは、コンポーネントのシンボル、モデル、パラメータ情報が、外部データベース内の当該コンポーネントのレコード定義の一部として保存される点です。参照される回路図コンポーネント（基盤となるコンポーネントライブラリ（*.SchLib）に保存）はシンボルのみで、リンクされたモデルも、定義済みの設計パラメータも持ちません。
• コンポーネントを配置すると、一致したデータベースレコード内の対応フィールドと、定義済みのマッピングに従って、パラメータおよびモデル情報がその場で生成されます。これらのパラメータのうち 1 つ以上が、定義された一致条件に従ってデータベースへの継続的なリンクを維持するために使用され、配置後の将来的な同期が可能になります。
• このリンク方法は、配置時にコンポーネントを動的に生成するため、「多数のデータベースレコード対 1 つの Altium Designer コンポーネント」という使い方に非常に適しています。
• DbLink 形式のデータベースリンクでは DbLink ファイルをライブラリパッケージ（または設計プロジェクト）に含める必要がありますが、DbLib/SVNDbLib ファイルはプロジェクトに追加する必要はありません。データベースライブラリ（DbLib）は Available File-based Libraries に含まれ、Components panel からアクセスできます。Available File-based Libraries は、Project Libraries、Installed Libraries、または指定した検索パス上で見つかったライブラリで構成される点を覚えておいてください。
• 通常、DbLib/SVNDbLib ファイルはライブラリ指向で構成します。たとえば、会社のデータベースに登録された抵抗器用に 1 つ、コンデンサ用に 1 つ、という具合です。

DbLib vs SVNDbLib

SVN Database Library は Database Library モデルの拡張であり、ソースのシンボルとモデルがバージョン管理下に保存される点が異なります。

ソースライブラリは Subversion ベースのリポジトリ内で作成・追加・保守されます。リポジトリへのリンク、および外部データベースへのリンクは、SVN Database Library ファイル（*.SVNDbLib）内で定義されます。また、このアプローチは Database Library の拡張であるため、しばしば Version-Controlled Database Library と呼ばれます。

Librarian or Designer?

バージョン管理されたデータベースライブラリは、基本的に Librarian として、または Designer としての 2 つのモードで作業できます。

Librarian としては、シンボル／モデルライブラリの外部ソース管理リポジトリをセットアップして保守するだけでなく、SVN Database Library ファイルの設定も担当します。これには次が含まれます：

• 外部コンポーネントデータベースへの接続。
• データベースレコードからコンポーネントのパラメータ／モデルへのマッピング定義。
• シンボルおよびモデルライブラリが保存されている SVN リポジトリへのリンク指定。

Designer としては、Librarian が生成した SVNDbLib ファイルを受け取り、Available File-based Libraries リストに追加して Components panel で利用可能にし、データベースコンポーネントを参照・配置します。

これらの役割の使い分けは会社によって異なります。大企業では、専任のライブラリセンターが設けられ、Librarian の役割として、ソース管理リポジトリ内のシンボル／モデルライブラリのセットアップと保守、および SVN Database Library ファイルの生成のみを担当することがあります。その後、SVNDbLib ファイルは社内の Designer に提供され、Designer はライブラリファイルをインストールして、設計でコンポーネントを配置するために使用します。

小規模な会社では、両方の役割を同一人物が担う場合もあります。その人物はライブラリのリポジトリをセットアップして保守するだけでなく、定義した SVNDbLib を設計作業でも使用します。

The Source Control Repository

Related article: Using External Version Control

シンボルおよびモデルのライブラリファイルは、Subversion（SVN）リポジトリに追加する必要があります。Altium Designer には SVN Version Control Provider が含まれており、Data Management - Version Control page（Preferences dialog 内）で有効化および設定します。SVN Version Control Provider を有効化すると、Data Management - Design Repositories page（Preferences dialog 内）でリポジトリを作成できます。

SVN リポジトリは、TortoiseSVN などの外部 SVN クライアント／サーバを使用して、Altium Designer の外部で作成・管理することもできます。既存のリポジトリには、Data Management - Design Repositories page（Preferences dialog 内）で接続できます。

リポジトリにファイルを追加する際に注意すべき重要な点として、各シンボルおよびモデルは must be stored in its own library file。通常のライブラリでは（任意の数のシンボル／モデルを保持可能）、1つのエントリを変更しただけでも、バージョン管理システムによって全体が「変更された」とマークされてしまいます。ライブラリファイルを「1ファイル＝1シンボル／1モデル」にしておくことで、バージョン管理の特性に合致し、何が変更され、何が変更されていないかを正確に追跡できます。

本ドキュメントでは、リポジトリはすでに作成済みであるものとします。

Using the Library Splitter Wizard

シンボルやモデルのライブラリを新規作成する場合は、1ファイルあたり1シンボル／1モデルを確実に守るのは難しくありません。しかし通常は、元となるソースライブラリがすでに存在します。これらのライブラリをSVNリポジトリへ追加するために、単一エンティティのファイルへ分割する作業を簡単にするため、Altium Designerには分割ツールである Library Splitter Wizard が用意されています。このウィザードを使うと、複数コンポーネントを含む回路図（*.SchLib）およびPCB（*.PcbLib）ライブラリを、個別のコンポーネントライブラリへ素早く分割できます。ウィザードは、回路図ライブラリエディタ、PCBライブラリエディタ、SVN Database Library Editorの Tools メニューから利用できます。

Library Splitter Wizard を使用して、ソースライブラリを「1ファイル＝1シンボル／1モデル」に分割します。

分割プロセスの準備には、次の手順が含まれます。

1. 分割したいソースライブラリファイルを追加します（同じフォルダに置かれている必要はありません）。Libraries to Split ページで、分割したい回路図またはPCBライブラリを選択します。Add ボタンをクリックすると、参照して目的のライブラリを追加するためのダイアログが開きます。追加したライブラリは、ウィザードの後段で個別のコンポーネントライブラリに分割されます。ソースライブラリは同一フォルダに存在する必要はありません。Remove ボタンで、リストから選択したライブラリを削除できます。

   

2. 出力ディレクトリを指定します。Output Directories ページで、個別コンポーネントライブラリの出力ディレクトリを設定します。リストに表示される Output Directory は、分割後のライブラリが配置されるパスです。必要に応じて Change Output Directory をクリックし、表示されている（選択中の）ディレクトリを更新します。ダイアログが開き、出力ディレクトリとして使用する更新後のフォルダを参照して選択できます。

   デフォルトでは、出力ディレクトリはソースライブラリが保存されているディレクトリと同じに設定されます。元のソースライブラリがすべて同一のソースディレクトリフォルダに保存されている場合は注意が必要です。出力ディレクトリを指定せずデフォルトのまま（同じソースディレクトリフォルダを指す状態）にすると、単一シンボル／単一モデルのライブラリが大量に混在することになり得ます。リポジトリ構造を作成する際にそれらを仕分けるのは、非常に時間がかかる可能性があります。

   

   分割したライブラリファイルはSVNリポジトリに追加するため、（シンボル／モデルファイルの観点で）リポジトリ内に作りたいフォルダ構造を、ローカルのハードディスク上であらかじめ用意しておくのは良い方法です。構造を定義したら、その構造内の各フォルダへソースライブラリをコピーします。そうすれば、各ソースライブラリの出力ディレクトリ設定はデフォルトのままで構いません。分割後、生成された単一ライブラリファイルはすでに正しい場所に配置されています。各フォルダから元のソースライブラリを削除し、使用するSVNクライアントでフォルダをリポジトリに追加できます。

3. ソースライブラリの分割方法を制御する追加オプションを設定します。これには、回路図コンポーネントライブラリに対して、各構成コンポーネントからパラメータ情報および／またはモデル情報を取り除き、シンボルだけを残すためのオプションなどが含まれます。

    
   Split Librariesページの2つの例。左：.PCBLib ファイルを変換する場合のSplit Librariesページ。右：.SCHLib ファイルを変換する場合のSplit Librariesページ。

   Options ページを使用して、ライブラリの分割方法を制御できます。 （上の画像に示す）ドロップダウンで、新規ファイルの扱いを選択します。Overwrite Existing Files（デフォルト）を選ぶと、新規作成されたファイルは既存ファイルを上書きします。Append Incrementing Number To File Names を選ぶと、ライブラリスプリッタは前のページ（Output Directories）で選択したすべての出力ディレクトリをスキャンし、上書きされないよう保護すべきファイルのリストを作成します。同名の新しいコンポーネントライブラリには、接尾辞として「_#Increment Number」が付加されます。

4. ソースライブラリとオプションを指定すると、ウィザードが解析を実行し、その結果として作成される単一シンボル／単一モデルのライブラリ一式が、レビュー用に一覧表示されます。生成される各分割ライブラリの名前に加え、そのライブラリ内の回路図コンポーネント／フットプリントモデルの実際の名前も表示されます。元のソースライブラリも一覧に表示されます。ライブラリに使用される名前は、構成要素となるコンポーネント／モデルに使用されている名前と同一になります。

   コンポーネント／モデル名に次の文字が使用されている場合、ライブラリ名を作成する際にアンダースコアに置き換えられます：'\'、 '/'、'!'、'''、'['、']'。

   

   作成されるコンポーネントライブラリは Review ページで確認できます。Splitted Library Name、 Component Name および Source Library が一覧表示され、分割プロセス中に作成される新しいファイルが示されます。各列の右側にある下向き矢印をクリックすると、その列のデータのドロップダウンリストに簡単にアクセスできます。この機能は、非常に大規模なライブラリのファイルをレビューする際に特に役立ちます。

5. 作成されるライブラリの一覧を確認し、Next をクリックして分割プロセスを進め、最終的にソース管理リポジトリへ追加するライブラリを取得します。 ウィザードが正常に完了したら、Finish をクリックして閉じます。

   

Using the SVN Database Library Conversion Wizard

既存ライブラリをSVNタイプのデータベースライブラリへ変換する別の方法として、SVN Database Library Conversion Wizard があります。このウィザードは、回路図、PCB、データベース、および統合ライブラリをSVNデータベースライブラリへ変換します。ウィザードには、ソースライブラリをどのように分割するか、どのリポジトリのどのディレクトリに格納するか、作成されるSVNDbLibおよびMDBデータベースファイルの出力ディレクトリなど、変換に関する複数のオプションがあります。 

このウィザードは、PCBまたは回路図ライブラリドキュメントを編集しているときに Tools メニューからアクセスできます。

このウィザードは、シンボルおよびフットプリントライブラリを分割してリポジトリにチェックインし、SVNDbLibとAccessデータベースファイルを作成します。

Where to Next?

データベースライブラリのさまざまな側面について詳しく学ぶには、次のページを参照してください。

• Creating & Defining the Database Library
• Modifying a Database Table
• Modifying Symbols & Footprints