Использование базы данных Asterisk (AstDB)

1. Назначение AstDB

В Asterisk есть мощный механизм для хранения значений, который называется базой данных Asterisk (AstDB). AstDB обеспечивает простой способ хранения данных для использования в диалплане. AstDB хранит данные в группах, которые называются семействами. Семейства определяются ключами. Например, у нас есть семейство name, мы бы могли хранить только одно значение с ключом key. Каждое хранящееся значение должно быть соотносимо с каким-то семейством.

2. Хранение данных в AstDB

Для хранения данных в AstDB применяется Set (), например:

exten => 123,1,Set (DB (name/key)=1)

Если в семействе name есть ключ key, это значение будет перезаписано на новое. Из командной строки это делается следующим образом:

data base put name key 1

3. Извлечение данных из AstDB

Для извлечения данных из AstDB также используется Set (). Извлечение значение key из семейства name:

exten => 123,1,Set (DB (name/key)=1)

Присвоение переменной key:

exten => 123,n,Set (KEY=${DB (name/key)})

Из командной строки это делается следующим образом: database get name key. Для просмотра всего содержимого AstDB используется команда database show.

4. Использование AstDB в диалплане

Существует много вариантов применения AstDB в диалплане. Чтобы показать Вам как это работает, мы рассмотрим простой пример с функцией BLACKLIST.
Если вы не хотите, чтобы к вам дозвонился определенный номер (например 7928XXXXXXX), то диалплан должен выглядеть следующим образом:

[incoming]
exten => 7928XXXXXXX,1,Answer ()
exten => 7928XXXXXXX,n,GotoIf ($[${BLACKLIST ()}=1]?blacklist)
exten => 7928XXXXXXX,n,GoTo (from-internal,s,1)
exten => 7928XXXXXXX,n (blacklist),Hangup ()
exten => h,1,Hangup ()
exten => i,1,Hangup ()

В первой строке контекста [incoming] устанавливается соединение с 7928XXXXXXX
Далее BLACKLIST проверяет в AstDB в семейтсве blacklist ключ, равный равный Caller*ID, со значением 1. Если ключ есть и значение равно единице, то BLACKLIST () возвращает 1. Если условие удовлетворяется, то выполняется экстеншен с пометкой blacklist (4 строка) и завершается вызов.
Чтобы добавить номер в черный список, выполните команду database put blacklist 7928XXXXXXX в командной строке Астериска.

5. Удаление данных из AstDB

Существует два способа удаления данных из базы данных Asterisk. Это удаление ключа и удаление всего семейства ключей.
Удаление ключа: DB_DELETE (name/key)
database del key (из командной строки)
Удаление всего семейства ключей: DBdeltree (name)
database deltree name (из командной строки)
Например:

[del-backlist]
exten => _X.,1,NoOp (${DB_DELETE (blacklist/${EXTEN})})
exten => _X.,n,Wait (1)
exten => _X.,n,Hangup ()

В контексте [del-backlist] при помощи функции DB_DELETE удаляется ключ из blacklist. А чтобы вызвать эту функцию в общем плане набора создадим экстеншен:
exten => _*9*X.,1,Goto (del-backlist,${EXTEN:3},1)
Для удаления всего семейства ключей:

[del-backlist]
exten => _X.,1,NoOp (${DBdeltree (blacklist)}
exten => _X.,n,Wait (1)
exten => _X.,n,Hangup ()
exten => _*8*X.,1,Goto (del-backlist,${EXTEN:3},1)