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

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

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

直接配置 — 単なるリンクを超えて

Altium Designerには、コンポーネントからデータベースにリンクする方法が3つあります。それぞれ、Database Linkファイル（*.DbLink）、Database Libraryファイル（*.DbLib）、SVN Database Libraryファイル（*.SVNDbLib）を使用します。DbLink方式は、設計（またはライブラリ）で使用するコンポーネントを、データベースに入力されたデータと効率的にリンクし、同期状態に保つ手段を提供します。DbLib/SVNDbLib方式は、この実績あるリンク機能の効率性に加え、データベースからコンポーネントを直接配置できる柔軟性を備えています。つまり、対応するデータベースレコードに保存された情報から、コンポーネントを動的に作成します。

データベースライブラリ機能をさらに詳しく説明する前に、これらの方式の使い方の違いについて確認しておきましょう。

Database Linkファイルを使用したリンク

Related page: 既存のコンポーネントを社内データベースにリンクする

• この方式では、Database Linkファイル（*.DbLink）が、回路図コンポーネントとデータベース内の一致するレコードとのリンクを定義します。レコードの照合はキーフィールドのリンクによって行われ、単一のキーフィールド（部品番号など）、または複数のキーフィールド（Where句を定義）を使用できます。
• このリンク方式では、コンポーネントのモデルとパラメーター情報を、Altium Designerのライブラリコンポーネントの一部として事前に定義する必要があります。また、ライブラリコンポーネントの定義には、必要なキーフィールド情報も含める必要があります。これらを定義したら、ライブラリパッケージまたは設計プロジェクトにDatabase Linkファイルを追加することで、コンポーネント情報（パラメーター）をデータベースのフィールドの内容と同期できます。
• 各データベースレコードで定義される物理コンポーネントを、それぞれ固有のAltium Designerライブラリコンポーネントに対応付ける必要はなく、複数のデータベースコンポーネントで同じコンポーネントシンボルを共有できます。ただし、このリンク方式は通常、「1つのデータベースレコードに対して1つのAltium Designerコンポーネント」という形で使用されます。この固有のAltium Designerコンポーネントは、回路図シートに配置されたインスタンスでも、コンポーネントライブラリ内の固有のコンポーネントでもかまいません。
• DbLink方式のデータベースリンクでは、Database Linkファイルをライブラリパッケージまたは設計プロジェクトに含めます。

Database Libraryファイルを使用したリンク

• この方式でも、Database Libraryファイル（*.DbLib）が、回路図コンポーネントとデータベース内の一致するレコードとのリンクを定義します。同様に、レコードの照合はキーフィールドのリンクによって行われ、単一のキーフィールド（部品番号など）、または複数のキーフィールド（Where句を定義）を使用できます。
• このリンク方式の主な違いは、コンポーネントのシンボル、モデル、パラメーター情報が、外部データベース内の該当コンポーネントのレコード定義の一部として保存されることです。参照先の回路図コンポーネント（元となるコンポーネントライブラリ（*.SchLib）に保存されているもの）はシンボルのみで、リンクされたモデルや定義済みの設計パラメーターはありません。
• コンポーネントを配置すると、一致するデータベースレコードの対応するフィールドを使用し、定義済みのマッピングに従って、そのコンポーネントのパラメーターとモデル情報がその場で作成されます。その後、定義された照合条件に従い、これらのパラメーターの1つ以上を使用してデータベースへのリンクを維持することで、配置後も同期できるようになります。
• このリンク方式では配置時にコンポーネントが動的に作成されるため、「複数のデータベースレコードに対して1つのAltium Designerコンポーネント」という使い方に非常に適しています。
• DbLinkファイルをライブラリパッケージ（または設計プロジェクト）に含める必要があるDbLink方式のデータベースリンクとは異なり、DbLib/SVNDbLibファイルをプロジェクトに追加する必要はありません。データベースライブラリ（DbLib）は、Componentsパネルからアクセスできる、使用可能なファイルベースライブラリに含まれます。使用可能なファイルベースライブラリには、プロジェクトライブラリ、インストール済みライブラリ、指定された検索パスで見つかったライブラリを含めることができます。
• 通常、DbLib/SVNDbLibファイルはライブラリ単位で構成します。たとえば、社内データベースに登録されているすべての抵抗器用に1つ、コンデンサー用にもう1つ、といった形です。

DbLibとSVNDbLibの比較

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

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

ライブラリ管理者、それとも設計者？

バージョン管理されたデータベースライブラリを使用する場合、基本的にLibrarianまたはDesignerの2つの役割があります。

ライブラリ管理者は、シンボルおよびモデルライブラリの外部ソース管理リポジトリの構築と保守に加え、SVN Database Libraryファイルの設定も担当します。これには、次の作業が含まれます。

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

設計者は、ライブラリ管理者が生成したSVNDbLibファイルを、Available File-based Librariesリストに追加して Componentsパネルで使用できるようにし、データベースコンポーネントを参照して配置します。

これらの役割の運用方法は、企業によって異なります。大企業では、専任のライブラリ管理部門を設け、ライブラリ管理者として、ソース管理リポジトリ内のシンボルおよびモデルライブラリの構築と保守、およびSVN Database Libraryファイルの生成のみを担当する場合があります。生成されたSVNDbLibファイルは社内の設計者に提供され、設計者はライブラリファイルをインストールして使用し、設計にコンポーネントを配置します。

小規模な企業では、同じ担当者が両方の役割を担う場合があります。その担当者は、ライブラリのリポジトリを構築・保守するだけでなく、設定したSVNDbLibを設計業務でも使用します。

ソース管理リポジトリ

Related article: 外部バージョン管理の使用

シンボルおよびモデルのライブラリファイルは、Subversion（SVN）リポジトリに追加する必要があります。Altium DesignerにはSVNバージョン管理プロバイダーが含まれており、PreferencesダイアログのData Management - Version Controlページで有効化および設定できます。SVNバージョン管理プロバイダーを有効にすると、PreferencesダイアログのData Management - Design Repositoriesページでリポジトリを作成できます。

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

リポジトリにファイルを追加する際の重要な注意点は、各シンボルとモデルがmust be stored in its own library fileということです。任意の数のシンボル／モデルを格納できる通常のライブラリでは、1つの項目を変更すると、バージョン管理システムによってすべての項目が変更済みとマークされます。ライブラリファイルごとにシンボル／モデルを1つだけ格納する方法は、バージョン管理の仕組みに適しており、何が変更され、何が変更されていないかを正確に追跡できます。

このドキュメントでは、リポジトリがすでに作成されていることを前提とします。

Library Splitter Wizardの使用

シンボルおよびモデルのライブラリを新規作成する場合、1つのファイルに1つのシンボル／モデルだけを格納することは容易です。ただし、通常はソースライブラリがすでに存在します。これらのライブラリを単一要素のファイルに分割し、SVNリポジトリに追加する作業を簡単にするため、Altium Designerには分割ツールであるLibrary Splitter Wizardが用意されています。このウィザードでは、複数のコンポーネントを含む回路図ライブラリ（*.SchLib）およびPCBライブラリ（*.PcbLib）を、個別のコンポーネントライブラリにすばやく分割できます。このウィザードには、回路図ライブラリエディター、PCBライブラリエディター、およびSVN Database LibraryエディターのToolsメニューからアクセスできます。

Library Splitter Wizardを使用して、ソースライブラリを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をクリックして閉じます。

   

SVNデータベースライブラリ変換ウィザードの使用

既存のライブラリをSVN形式のデータベースライブラリに変換するもう1つの方法は、SVNデータベースライブラリ変換ウィザードを使用することです。このウィザードは、回路図ライブラリ、PCBライブラリ、データベースライブラリ、統合ライブラリをSVNデータベースライブラリに変換します。ウィザードには、ソースライブラリの分割方法、保存先のリポジトリとディレクトリ、作成するSVNDbLibファイルとMDBデータベースファイルの出力ディレクトリなど、変換に関するさまざまなオプションが用意されています。 

このウィザードは、PCBライブラリまたは回路図ライブラリのドキュメントを編集中に、Toolsメニューから起動できます。

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

次のステップ

データベースライブラリの操作に関する各種の詳細については、次のページを参照してください。

• データベースライブラリの作成と定義
• データベーステーブルの変更
• シンボルとフットプリントの変更