Библиотеки баз данных

Altium Designer позволяет размещать компоненты непосредственно из базы данных компании путем создания и использования Database Library. Размещение выполняется с помощью панели Components, которая после установки библиотеки базы данных служит средством просмотра вашей базы данных.

После размещения сведения о параметрах проекта можно синхронизировать между размещенными компонентами и соответствующими связанными записями базы данных с помощью команды Tools » Update Parameters From Database. Полное обновление компонентов, включая графическое условное обозначение, ссылки на модели и параметры, можно выполнить с помощью команды Tools » Update From Libraries. Сведения о параметрах из базы данных также можно включить в итоговую спецификацию (BOM), подготовленную для закупки компонентов.

Непосредственное размещение — больше, чем просто связывание

Altium Designer предоставляет три способа связывания компонента с базой данных: с помощью файла 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 — несколько компонентов базы данных могут использовать одно и то же условное обозначение, — этот способ связывания обычно применяется по принципу «одна запись базы данных — один компонент Altium Designer». Уникальным компонентом Altium Designer может быть как экземпляр, размещенный на листе схемы, так и отдельный компонент в библиотеке компонентов.
• При связывании с базой данных по методу DbLink файл Database Link включается в пакет библиотек или проект.

Связывание с помощью файла Database Library

• При использовании этого способа файл Database Library (*.DbLib) также определяет связь между компонентом схемы и соответствующей записью базы данных. Как и в предыдущем случае, соответствие записи устанавливается по ключевым полям: это может быть одно ключевое поле, например номер детали, или несколько ключевых полей, заданных с помощью условия WHERE.
• Ключевое отличие этого способа связывания состоит в том, что сведения об условном обозначении, моделях и параметрах компонента хранятся в составе записи этого компонента во внешней базе данных. Компонент схемы, на который ссылается запись и который хранится в исходной библиотеке компонентов (*.SchLib), представляет собой только условное обозначение: у него нет связанных моделей и заданных параметров проекта.
• При размещении компонента сведения о его параметрах и моделях формируются на лету на основе соответствующих полей найденной записи базы данных и в соответствии с заданным сопоставлением. Затем один или несколько этих параметров используются для поддержания связи с базой данных согласно заданным критериям соответствия, обеспечивая возможность последующей синхронизации после размещения.
• Благодаря динамическому созданию компонентов в момент размещения этот способ связывания хорошо подходит для использования по принципу «много записей базы данных — один компонент Altium Designer».
• В отличие от связывания по методу DbLink, при котором файл DbLink должен быть включен в пакет библиотек или проект, файл DbLib/SVNDbLib добавлять в проект не требуется. Библиотека базы данных (DbLib) включается в список доступных файловых библиотек, доступ к которому осуществляется через панель Components. Помните, что доступные файловые библиотеки могут включать библиотеки проекта, установленные библиотеки или библиотеки, найденные по указанным путям поиска.
• Обычно файлы DbLib/SVNDbLib организуют по типам библиотек. Например, один файл может содержать все резисторы, описанные в базе данных компании, другой — конденсаторы и т. д.

DbLib и SVNDbLib

Библиотека SVN Database Library — это расширение модели Database Library, отличающееся тем, что исходные условные обозначения и модели хранятся под управлением системы контроля версий.

Исходные библиотеки создаются, пополняются и поддерживаются в репозитории Subversion. Связь с репозиторием и внешней базой данных определяется в файле SVN Database Library (*.SVNDbLib). Поскольку этот подход является расширением Database Library, его часто называют Version-Controlled Database Library.

Библиотекарь или разработчик?

Работать с библиотекой базы данных под управлением системы контроля версий можно в двух основных ролях: Librarian или Designer.

В роли библиотекаря вам потребуется не только настроить и поддерживать внешний репозиторий системы контроля версий для библиотек символов и моделей, но и настроить файл библиотеки базы данных SVN. Это включает:

• Подключение к внешней базе данных компонентов.
• Настройку соответствия между записями базы данных и параметрами/моделями компонентов.
• Указание ссылки на репозиторий SVN, в котором хранятся библиотеки символов и моделей.

В роли разработчика вы будете использовать созданный библиотекарем файл SVNDbLib, добавив его в список Available File-based Libraries, чтобы он стал доступен на панели Components. После этого вы сможете просматривать компоненты базы данных и размещать их в проекте.

Распределение этих ролей зависит от компании. В крупной компании может существовать специализированное подразделение по ведению библиотек, которое в роли библиотекаря занимается исключительно настройкой и сопровождением библиотек символов и моделей в репозитории системы контроля версий, а также созданием файлов библиотеки базы данных SVN. Затем файлы SVNDbLib предоставляются разработчикам этой компании, которые устанавливают и используют библиотечные файлы для размещения компонентов в своих проектах.

В небольшой компании обе роли может выполнять один человек. Он будет не только настраивать и поддерживать репозиторий библиотек, но и использовать настроенные файлы SVNDbLib при проектировании.

Репозиторий системы контроля версий

Related article: Использование внешней системы контроля версий

Файлы библиотек символов и моделей необходимо добавить в репозиторий Subversion (SVN). Altium Designer включает поставщик услуг контроля версий SVN, который включается и настраивается на странице Data Management - Version Control диалогового окна Preferences. После включения поставщика услуг контроля версий SVN можно создать репозиторий на странице Data Management - Design Repositories диалогового окна Preferences.

Репозитории SVN также можно создавать и администрировать вне Altium Designer с помощью внешнего клиента и сервера SVN, например TortoiseSVN. Подключиться к существующему репозиторию можно на странице Data Management - Design Repositories диалогового окна Preferences.

При добавлении файлов в репозиторий важно учитывать, что каждый символ и каждая модель must be stored in its own library file. В обычной библиотеке, которая может содержать любое количество символов или моделей, изменение одного элемента приведёт к тому, что система контроля версий отметит все элементы как изменённые. Хранение одного символа или одной модели в каждом библиотечном файле соответствует принципам работы системы контроля версий и позволяет точно отслеживать, что изменилось, а что осталось без изменений.

В этом документе предполагается, что репозиторий уже создан.

Использование мастера разделения библиотек

Если библиотеки символов и моделей создаются с нуля, обеспечить хранение только одного символа или одной модели в каждом файле несложно. Однако, как правило, исходные библиотеки уже существуют. Чтобы упростить их разделение на файлы с одним элементом для добавления в репозиторий SVN, в Altium Designer предусмотрен инструмент разделения — Library Splitter Wizard. Этот мастер позволяет быстро разделить библиотеки схемных компонентов (*.SchLib) и библиотеки посадочных мест печатных плат (*.PcbLib), содержащие несколько компонентов, на библиотеки отдельных компонентов. Мастер доступен в меню Tools редактора библиотек схемных компонентов, редактора библиотек посадочных мест и редактора библиотек базы данных SVN.

Разделите исходные библиотеки на файлы, содержащие по одному символу или одной модели, с помощью Library Splitter Wizard.

Подготовка к разделению включает следующие шаги:

1. Добавление исходных библиотечных файлов, которые требуется разделить (они могут находиться в разных папках). На странице Libraries to Split выберите библиотеки схемных компонентов или посадочных мест, которые нужно разделить. Нажмите кнопку Add, чтобы открыть диалоговое окно для поиска и добавления нужных библиотек в список. Добавленные библиотеки будут разделены на библиотеки отдельных компонентов на последующих шагах мастера. Исходные библиотеки могут находиться в разных папках. Чтобы удалить выбранную библиотеку из списка, нажмите кнопку Remove.

   

2. Указание выходного каталога. На странице Output Directories задаются выходные каталоги для библиотек отдельных компонентов. В поле Output Directory указан путь, по которому будут размещены библиотеки после разделения. При необходимости нажмите Change Output Directory, чтобы изменить выбранный каталог в списке. Откроется диалоговое окно, в котором можно найти и выбрать другую выходную папку.

   По умолчанию в качестве выходного каталога используется каталог, в котором хранится исходная библиотека. Будьте внимательны, если все исходные библиотеки находятся в одной папке. Если не изменить выходные каталоги и оставить значения по умолчанию, указывающие на эту общую исходную папку, в ней может оказаться огромное количество вперемешку расположенных библиотек отдельных символов и моделей. Их сортировка при создании структуры репозитория может занять очень много времени.

   

   Поскольку файлы разделённых библиотек будут добавлены в репозиторий SVN, имеет смысл заранее создать на локальном диске нужную структуру папок для файлов символов и моделей. Подготовив структуру, скопируйте исходные библиотеки в соответствующие папки. После этого для каждой исходной библиотеки можно оставить выходной каталог по умолчанию. По завершении разделения созданные файлы библиотек отдельных компонентов уже будут находиться в нужных местах. Затем можно удалить исходную библиотеку из каждой папки и добавить папки в репозиторий с помощью выбранного клиента SVN.

3. Настройка дополнительных параметров разделения исходных библиотек. Для библиотеки схемных компонентов, в частности, доступны параметры, позволяющие удалить из каждого компонента сведения о параметрах и/или моделях, оставив только сам символ.

    
   Два варианта страницы Split Libraries: слева — при преобразовании файла .PCBLib , справа — при преобразовании файла .SCHLib .

   Управлять разделением библиотек можно на странице 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 Database Library Conversion Wizard

Еще один способ преобразования существующих библиотек в библиотеку базы данных типа SVN — использование мастера SVN Database Library Conversion Wizard. Этот мастер преобразует библиотеки схемных компонентов, библиотеки посадочных мест, библиотеки баз данных и интегрированные библиотеки в библиотеки баз данных SVN. В мастере предусмотрен ряд параметров преобразования: способ разделения исходных библиотек, выбор репозитория и каталогов для их хранения, а также выходного каталога для создаваемых файлов SVNDbLib и базы данных MDB. 

Мастер доступен в меню Tools при редактировании документа библиотеки посадочных мест или схемных компонентов.

Мастер разделяет библиотеки символов и посадочных мест, помещает их в репозиторий и создает файлы SVNDbLib и базы данных Access.

Что дальше?

Подробнее о различных аспектах работы с библиотеками баз данных см. на следующих страницах:

• Создание и настройка библиотеки базы данных
• Изменение таблицы базы данных
• Изменение символов и посадочных мест