3 use vars qw(@ISA @EXPORT_OK $DEBUG $setup_hack %dbdef_cache);
4 use subs qw(reload_dbdef);
6 use DBIx::DBSchema 0.33;
7 use DBIx::DBSchema::Table;
8 use DBIx::DBSchema::Column 0.06;
9 use DBIx::DBSchema::Index;
12 @EXPORT_OK = qw( dbdef dbdef_dist reload_dbdef );
19 FS::Schema - Freeside database schema
23 use FS::Schema qw(dbdef dbdef_dist reload_dbdef);
25 $dbdef = reload_dbdef;
26 $dbdef = reload_dbdef "/non/standard/filename";
28 $dbdef_dist = dbdef_dist;
32 This class represents the database schema.
38 =item reload_dbdef([FILENAME])
40 Load a database definition (see L<DBIx::DBSchema>), optionally from a
41 non-default filename. This command is executed at startup unless
42 I<$FS::Schema::setup_hack> is true. Returns a DBIx::DBSchema object.
49 unless ( exists $dbdef_cache{$file} ) {
50 warn "[debug]$me loading dbdef for $file\n" if $DEBUG;
51 $dbdef_cache{$file} = DBIx::DBSchema->load( $file )
52 or die "can't load database schema from $file: $DBIx::DBSchema::errstr\n";
54 warn "[debug]$me re-using cached dbdef for $file\n" if $DEBUG;
56 $dbdef = $dbdef_cache{$file};
61 Returns the current database definition (represents the current database,
62 assuming it is up-to-date). See L<DBIx::DBSchema>.
68 =item dbdef_dist [ DATASRC ]
70 Returns the current canoical database definition as defined in this file.
72 Optionally, pass a DBI data source to enable syntax specific to that database.
73 Currently, this enables "TYPE=InnoDB" for MySQL databases.
78 my $datasrc = @_ ? shift : '';
80 my $local_options = '';
81 if ( $datasrc =~ /^dbi:mysql/i ) {
82 $local_options = 'TYPE=InnoDB';
86 # create a dbdef object from the old data structure
89 my $tables_hashref = tables_hashref();
92 my $dbdef = new DBIx::DBSchema map {
98 while (@{$tables_hashref->{$tablename}{'columns'}}) {
99 #my($name, $type, $null, $length, $default, $local) =
101 splice @{$tables_hashref->{$tablename}{'columns'}}, 0, 6;
102 my %hash = map { $_ => shift @coldef }
103 qw( name type null length default local );
105 unless ( defined $hash{'default'} ) {
106 warn "$tablename:\n".
107 join('', map "$_ => $hash{$_}\n", keys %hash) ;# $stop = <STDIN>;
110 push @columns, new DBIx::DBSchema::Column ( \%hash );
113 #false laziness w/sub indices in DBIx::DBSchema::DBD (well, sorta)
114 #and sub sql_create_table in DBIx::DBSchema::Table (slighty more?)
115 my $unique = $tables_hashref->{$tablename}{'unique'};
116 my $index = $tables_hashref->{$tablename}{'index'};
119 DBIx::DBSchema::Index->new({
120 'name' => $tablename. $indexnum++,
127 DBIx::DBSchema::Index->new({
128 'name' => $tablename. $indexnum++,
135 DBIx::DBSchema::Table->new({
136 'name' => $tablename,
137 'primary_key' => $tables_hashref->{$tablename}{'primary_key'},
138 'columns' => \@columns,
139 'indices' => \@indices,
140 'local_options' => $local_options,
143 } keys %$tables_hashref;
146 warn "[debug]$me initial dbdef_dist created ($dbdef) with tables:\n";
147 warn "[debug]$me $_\n" foreach $dbdef->tables;
150 #add radius attributes to svc_acct
152 #my($svc_acct)=$dbdef->table('svc_acct');
155 #foreach $attribute (@attributes) {
156 # $svc_acct->addcolumn ( new DBIx::DBSchema::Column (
157 # 'radius_'. $attribute,
164 #foreach $attribute (@check_attributes) {
165 # $svc_acct->addcolumn( new DBIx::DBSchema::Column (
173 #create history tables (false laziness w/create-history-tables)
175 grep { ! /^clientapi_session/ }
179 my $tableobj = $dbdef->table($table)
180 or die "unknown table $table";
182 my %indices = $tableobj->indices;
184 my %h_indices = map {
186 DBIx::DBSchema::Index->new({
187 'name' => 'h_'. $indices{$_}->name,
189 'columns' => [ @{$indices{$_}->columns} ],
195 $h_indices{"h_${table}_srckey"} = DBIx::DBSchema::Index->new({
196 'name' => "h_${table}_srckey",
198 'columns' => [ 'history_action', #right?
199 $tableobj->primary_key,
203 $h_indices{"h_${table}_srckey2"} = DBIx::DBSchema::Index->new({
204 'name' => "h_${table}_srckey2",
206 'columns' => [ 'history_date',
207 $tableobj->primary_key,
211 my $h_tableobj = DBIx::DBSchema::Table->new( {
212 'name' => "h_$table",
213 'primary_key' => 'historynum',
214 'indices' => \%h_indices,
215 'local_options' => $local_options,
217 DBIx::DBSchema::Column->new( {
218 'name' => 'historynum',
220 'null' => 'NOT NULL',
225 DBIx::DBSchema::Column->new( {
226 'name' => 'history_date',
233 DBIx::DBSchema::Column->new( {
234 'name' => 'history_user',
236 'null' => 'NOT NULL',
241 DBIx::DBSchema::Column->new( {
242 'name' => 'history_action',
244 'null' => 'NOT NULL',
250 my $column = $tableobj->column($_);
252 #clone so as to not disturb the original
253 $column = DBIx::DBSchema::Column->new( {
254 map { $_ => $column->$_() }
255 qw( name type null length default local )
258 if ( $column->type =~ /^(\w*)SERIAL$/i ) {
259 $column->type('int');
260 $column->null('NULL');
262 #$column->default('')
263 # if $column->default =~ /^nextval\(/i;
264 #( my $local = $column->local ) =~ s/AUTO_INCREMENT//i;
265 #$column->local($local);
270 $dbdef->addtable($h_tableobj);
273 if ( $datasrc =~ /^dbi:mysql/i ) {
275 my $dup_lock_table = DBIx::DBSchema::Table->new( {
276 'name' => 'duplicate_lock',
277 'primary_key' => 'duplocknum',
278 'local_options' => $local_options,
280 DBIx::DBSchema::Column->new( {
281 'name' => 'duplocknum',
283 'null' => 'NOT NULL',
288 DBIx::DBSchema::Column->new( {
289 'name' => 'lockname',
291 'null' => 'NOT NULL',
297 'indices' => { 'duplicate_lock1' =>
298 DBIx::DBSchema::Index->new({
299 'name' => 'duplicate_lock1',
301 'columns' => [ 'lockname' ],
306 $dbdef->addtable($dup_lock_table);
316 my $char_d = 80; #default maxlength for text fields
318 #my(@date_type) = ( 'timestamp', '', '' );
319 my @date_type = ( 'int', 'NULL', '' );
320 my @perl_type = ( 'text', 'NULL', '' );
321 my @money_type = ( 'decimal', '', '10,2' );
322 my @money_typen = ( 'decimal', 'NULL', '10,2' );
324 my $username_len = 32; #usernamemax config file
326 # name type nullability length default local
332 'agentnum', 'serial', '', '', '', '',
333 'agent', 'varchar', '', $char_d, '', '',
334 'typenum', 'int', '', '', '', '',
335 'ticketing_queueid', 'int', 'NULL', '', '', '',
336 'invoice_template', 'varchar', 'NULL', $char_d, '', '',
337 'agent_custnum', 'int', 'NULL', '', '', '',
338 'disabled', 'char', 'NULL', 1, '', '',
339 'username', 'varchar', 'NULL', $char_d, '', '', #deprecated
340 '_password', 'varchar', 'NULL', $char_d, '', '', #deprecated
341 'freq', 'int', 'NULL', '', '', '', #deprecated (never used)
342 'prog', @perl_type, '', '', #deprecated (never used)
344 'primary_key' => 'agentnum',
345 #'unique' => [ [ 'agent_custnum' ] ], #one agent per customer?
346 #insert is giving it a value, tho..
347 #'index' => [ ['typenum'], ['disabled'] ],
349 'index' => [ ['typenum'], ['disabled'], ['agent_custnum'] ],
354 'typenum', 'serial', '', '', '', '',
355 'atype', 'varchar', '', $char_d, '', '',
357 'primary_key' => 'typenum',
364 'typepkgnum', 'serial', '', '', '', '',
365 'typenum', 'int', '', '', '', '',
366 'pkgpart', 'int', '', '', '', '',
368 'primary_key' => 'typepkgnum',
369 'unique' => [ ['typenum', 'pkgpart'] ],
370 'index' => [ ['typenum'] ],
375 'invnum', 'serial', '', '', '', '',
376 'custnum', 'int', '', '', '', '',
377 '_date', @date_type, '', '',
378 'charged', @money_type, '', '',
379 'printed', 'int', '', '', '', '',
380 'closed', 'char', 'NULL', 1, '', '',
382 'primary_key' => 'invnum',
384 'index' => [ ['custnum'], ['_date'] ],
387 'cust_bill_event' => {
389 'eventnum', 'serial', '', '', '', '',
390 'invnum', 'int', '', '', '', '',
391 'eventpart', 'int', '', '', '', '',
392 '_date', @date_type, '', '',
393 'status', 'varchar', '', $char_d, '', '',
394 'statustext', 'text', 'NULL', '', '', '',
396 'primary_key' => 'eventnum',
397 #no... there are retries now #'unique' => [ [ 'eventpart', 'invnum' ] ],
399 'index' => [ ['invnum'], ['status'] ],
402 'part_bill_event' => {
404 'eventpart', 'serial', '', '', '', '',
405 'freq', 'varchar', 'NULL', $char_d, '', '',
406 'payby', 'char', '', 4, '', '',
407 'event', 'varchar', '', $char_d, '', '',
408 'eventcode', @perl_type, '', '',
409 'seconds', 'int', 'NULL', '', '', '',
410 'weight', 'int', '', '', '', '',
411 'plan', 'varchar', 'NULL', $char_d, '', '',
412 'plandata', 'text', 'NULL', '', '', '',
413 'reason', 'int', 'NULL', '', '', '',
414 'disabled', 'char', 'NULL', 1, '', '',
416 'primary_key' => 'eventpart',
418 'index' => [ ['payby'], ['disabled'], ],
423 'eventpart', 'serial', '', '', '', '',
424 'agentnum', 'int', 'NULL', '', '', '',
425 'event', 'varchar', '', $char_d, '', '',
426 'eventtable', 'varchar', '', $char_d, '', '',
427 'check_freq', 'varchar', 'NULL', $char_d, '', '',
428 'weight', 'int', '', '', '', '',
429 'action', 'varchar', '', $char_d, '', '',
430 'disabled', 'char', 'NULL', 1, '', '',
432 'primary_key' => 'eventpart',
434 'index' => [ ['agentnum'], ['eventtable'], ['check_freq'], ['disabled'], ],
437 'part_event_option' => {
439 'optionnum', 'serial', '', '', '', '',
440 'eventpart', 'int', '', '', '', '',
441 'optionname', 'varchar', '', $char_d, '', '',
442 'optionvalue', 'text', 'NULL', '', '', '',
444 'primary_key' => 'optionnum',
446 'index' => [ [ 'eventpart' ], [ 'optionname' ] ],
449 'part_event_condition' => {
451 'eventconditionnum', 'serial', '', '', '', '',
452 'eventpart', 'int', '', '', '', '',
453 'conditionname', 'varchar', '', $char_d, '', '',
455 'primary_key' => 'eventconditionnum',
457 'index' => [ [ 'eventpart' ], [ 'conditionname' ] ],
460 'part_event_condition_option' => {
462 'optionnum', 'serial', '', '', '', '',
463 'eventconditionnum', 'int', '', '', '', '',
464 'optionname', 'varchar', '', $char_d, '', '',
465 'optionvalue', 'text', 'NULL', '', '', '',
467 'primary_key' => 'optionnum',
469 'index' => [ [ 'eventconditionnum' ], [ 'optionname' ] ],
472 'part_event_condition_option_option' => {
474 'optionoptionnum', 'serial', '', '', '', '',
475 'optionnum', 'int', '', '', '', '',
476 'optionname', 'varchar', '', $char_d, '', '',
477 'optionvalue', 'text', 'NULL', '', '', '',
479 'primary_key' => 'optionoptionnum',
481 'index' => [ [ 'optionnum' ], [ 'optionname' ] ],
486 'eventnum', 'serial', '', '', '', '',
487 'eventpart', 'int', '', '', '', '',
488 'tablenum', 'int', '', '', '', '',
489 '_date', @date_type, '', '',
490 'status', 'varchar', '', $char_d, '', '',
491 'statustext', 'text', 'NULL', '', '', '',
493 'primary_key' => 'eventnum',
494 #no... there are retries now #'unique' => [ [ 'eventpart', 'invnum' ] ],
496 'index' => [ ['eventpart'], ['tablenum'], ['status'] ],
501 'billpkgnum', 'serial', '', '', '', '',
502 'pkgnum', 'int', '', '', '', '',
503 'pkgpart_override', 'int', 'NULL', '', '', '',
504 'invnum', 'int', '', '', '', '',
505 'setup', @money_type, '', '',
506 'recur', @money_type, '', '',
507 'sdate', @date_type, '', '',
508 'edate', @date_type, '', '',
509 'itemdesc', 'varchar', 'NULL', $char_d, '', '',
510 'section', 'varchar', 'NULL', $char_d, '', '',
511 'quantity', 'int', 'NULL', '', '', '',
512 'unitsetup', @money_typen, '', '',
513 'unitrecur', @money_typen, '', '',
515 'primary_key' => 'billpkgnum',
517 'index' => [ ['invnum'], [ 'pkgnum' ] ],
520 'cust_bill_pkg_detail' => {
522 'detailnum', 'serial', '', '', '', '',
523 'billpkgnum', 'int', 'NULL', '', '', '', # should not be nullable
524 'pkgnum', 'int', 'NULL', '', '', '', # deprecated
525 'invnum', 'int', 'NULL', '', '', '', # deprecated
526 'amount', @money_typen, '', '',
527 'format', 'char', 'NULL', 1, '', '',
528 'classnum', 'char', 'NULL', 1, '', '',
529 'detail', 'varchar', '', $char_d, '', '',
531 'primary_key' => 'detailnum',
533 'index' => [ [ 'billpkgnum' ], [ 'classnum' ], [ 'pkgnum', 'invnum' ] ],
536 'cust_bill_pkg_display' => {
538 'billpkgdisplaynum', 'serial', '', '', '', '',
539 'billpkgnum', 'int', '', '', '', '',
540 'section', 'varchar', 'NULL', $char_d, '', '',
541 #'unitsetup', @money_typen, '', '', #override the linked real one?
542 #'unitrecur', @money_typen, '', '', #this too?
543 'post_total', 'char', 'NULL', 1, '', '',
544 'type', 'char', 'NULL', 1, '', '',
545 'summary', 'char', 'NULL', 1, '', '',
547 'primary_key' => 'billpkgdisplaynum',
549 'index' => [ ['billpkgnum'], ],
554 'crednum', 'serial', '', '', '', '',
555 'custnum', 'int', '', '', '', '',
556 '_date', @date_type, '', '',
557 'amount', @money_type, '', '',
558 'otaker', 'varchar', '', 32, '', '',
559 'reason', 'text', 'NULL', '', '', '',
560 'reasonnum', 'int', 'NULL', '', '', '',
561 'closed', 'char', 'NULL', 1, '', '',
563 'primary_key' => 'crednum',
565 'index' => [ ['custnum'], ['_date'] ],
568 'cust_credit_bill' => {
570 'creditbillnum', 'serial', '', '', '', '',
571 'crednum', 'int', '', '', '', '',
572 'invnum', 'int', '', '', '', '',
573 '_date', @date_type, '', '',
574 'amount', @money_type, '', '',
576 'primary_key' => 'creditbillnum',
578 'index' => [ ['crednum'], ['invnum'] ],
581 'cust_credit_bill_pkg' => {
583 'creditbillpkgnum', 'serial', '', '', '', '',
584 'creditbillnum', 'int', '', '', '', '',
585 'billpkgnum', 'int', '', '', '', '',
586 'amount', @money_type, '', '',
587 'setuprecur', 'varchar', '', $char_d, '', '',
588 'sdate', @date_type, '', '',
589 'edate', @date_type, '', '',
591 'primary_key' => 'creditbillpkgnum',
593 'index' => [ [ 'creditbillnum' ], [ 'billpkgnum' ], ],
598 'custnum', 'serial', '', '', '', '',
599 'agentnum', 'int', '', '', '', '',
600 'agent_custid', 'varchar', 'NULL', $char_d, '', '',
601 'custbatch', 'varchar', 'NULL', $char_d, '', '',
602 # 'titlenum', 'int', 'NULL', '', '', '',
603 'last', 'varchar', '', $char_d, '', '',
604 # 'middle', 'varchar', 'NULL', $char_d, '', '',
605 'first', 'varchar', '', $char_d, '', '',
606 'ss', 'varchar', 'NULL', 11, '', '',
607 'stateid', 'varchar', 'NULL', $char_d, '', '',
608 'stateid_state', 'varchar', 'NULL', $char_d, '', '',
609 'birthdate' ,@date_type, '', '',
610 'signupdate',@date_type, '', '',
611 'dundate', @date_type, '', '',
612 'company', 'varchar', 'NULL', $char_d, '', '',
613 'address1', 'varchar', '', $char_d, '', '',
614 'address2', 'varchar', 'NULL', $char_d, '', '',
615 'city', 'varchar', '', $char_d, '', '',
616 'county', 'varchar', 'NULL', $char_d, '', '',
617 'state', 'varchar', 'NULL', $char_d, '', '',
618 'zip', 'varchar', 'NULL', 10, '', '',
619 'country', 'char', '', 2, '', '',
620 'daytime', 'varchar', 'NULL', 20, '', '',
621 'night', 'varchar', 'NULL', 20, '', '',
622 'fax', 'varchar', 'NULL', 12, '', '',
623 'ship_last', 'varchar', 'NULL', $char_d, '', '',
624 # 'ship_middle', 'varchar', 'NULL', $char_d, '', '',
625 'ship_first', 'varchar', 'NULL', $char_d, '', '',
626 'ship_company', 'varchar', 'NULL', $char_d, '', '',
627 'ship_address1', 'varchar', 'NULL', $char_d, '', '',
628 'ship_address2', 'varchar', 'NULL', $char_d, '', '',
629 'ship_city', 'varchar', 'NULL', $char_d, '', '',
630 'ship_county', 'varchar', 'NULL', $char_d, '', '',
631 'ship_state', 'varchar', 'NULL', $char_d, '', '',
632 'ship_zip', 'varchar', 'NULL', 10, '', '',
633 'ship_country', 'char', 'NULL', 2, '', '',
634 'ship_daytime', 'varchar', 'NULL', 20, '', '',
635 'ship_night', 'varchar', 'NULL', 20, '', '',
636 'ship_fax', 'varchar', 'NULL', 12, '', '',
637 'payby', 'char', '', 4, '', '',
638 'payinfo', 'varchar', 'NULL', 512, '', '',
639 'paycvv', 'varchar', 'NULL', 512, '', '',
640 'paymask', 'varchar', 'NULL', $char_d, '', '',
641 #'paydate', @date_type, '', '',
642 'paydate', 'varchar', 'NULL', 10, '', '',
643 'paystart_month', 'int', 'NULL', '', '', '',
644 'paystart_year', 'int', 'NULL', '', '', '',
645 'payissue', 'varchar', 'NULL', 2, '', '',
646 'payname', 'varchar', 'NULL', $char_d, '', '',
647 'paystate', 'varchar', 'NULL', $char_d, '', '',
648 'paytype', 'varchar', 'NULL', $char_d, '', '',
649 'payip', 'varchar', 'NULL', 15, '', '',
650 'tax', 'char', 'NULL', 1, '', '',
651 'otaker', 'varchar', '', 32, '', '',
652 'refnum', 'int', '', '', '', '',
653 'referral_custnum', 'int', 'NULL', '', '', '',
654 'comments', 'text', 'NULL', '', '', '',
655 'spool_cdr','char', 'NULL', 1, '', '',
656 'squelch_cdr','char', 'NULL', 1, '', '',
657 'invoice_terms', 'varchar', 'NULL', $char_d, '', '',
659 'primary_key' => 'custnum',
660 'unique' => [ [ 'agentnum', 'agent_custid' ] ],
661 #'index' => [ ['last'], ['company'] ],
662 'index' => [ ['last'], [ 'company' ], [ 'referral_custnum' ],
663 [ 'daytime' ], [ 'night' ], [ 'fax' ], [ 'refnum' ],
664 [ 'county' ], [ 'state' ], [ 'country' ], [ 'zip' ],
665 [ 'ship_last' ], [ 'ship_company' ],
666 [ 'ship_daytime' ], [ 'ship_night' ], [ 'ship_fax' ],
667 [ 'payby' ], [ 'paydate' ],
668 [ 'agentnum' ], [ 'custbatch' ],
672 'cust_main_invoice' => {
674 'destnum', 'serial', '', '', '', '',
675 'custnum', 'int', '', '', '', '',
676 'dest', 'varchar', '', $char_d, '', '',
678 'primary_key' => 'destnum',
680 'index' => [ ['custnum'], ],
683 'cust_main_note' => {
685 'notenum', 'serial', '', '', '', '',
686 'custnum', 'int', '', '', '', '',
687 '_date', @date_type, '', '',
688 'otaker', 'varchar', '', 32, '', '',
689 'comments', 'text', 'NULL', '', '', '',
691 'primary_key' => 'notenum',
693 'index' => [ [ 'custnum' ], [ '_date' ], ],
696 'cust_main_county' => { #county+state+country are checked off the
697 #cust_main_county for validation and to provide
700 'taxnum', 'serial', '', '', '', '',
701 'state', 'varchar', 'NULL', $char_d, '', '',
702 'county', 'varchar', 'NULL', $char_d, '', '',
703 'country', 'char', '', 2, '', '',
704 'taxclass', 'varchar', 'NULL', $char_d, '', '',
705 'exempt_amount', @money_type, '', '',
706 'tax', 'real', '', '', '', '', #tax %
707 'taxname', 'varchar', 'NULL', $char_d, '', '',
708 'setuptax', 'char', 'NULL', 1, '', '', # Y = setup tax exempt
709 'recurtax', 'char', 'NULL', 1, '', '', # Y = recur tax exempt
711 'primary_key' => 'taxnum',
713 # 'unique' => [ ['taxnum'], ['state', 'county'] ],
714 'index' => [ [ 'county' ], [ 'state' ], [ 'country' ] ],
719 'taxnum', 'serial', '', '', '', '',
720 'geocode', 'varchar', 'NULL', $char_d, '', '',#cch provides 10 char
721 'data_vendor', 'varchar', 'NULL', $char_d, '', '',#auto update source
722 'location', 'varchar', 'NULL', $char_d, '', '',#provided by tax authority
723 'taxclassnum', 'int', '', '', '', '',
724 'effective_date', @date_type, '', '',
725 'tax', 'real', '', '', '', '', # tax %
726 'excessrate', 'real', 'NULL','', '', '', # second tax %
727 'taxbase', @money_typen, '', '', # amount at first tax rate
728 'taxmax', @money_typen, '', '', # maximum about at both rates
729 'usetax', 'real', 'NULL', '', '', '', # tax % when non-local
730 'useexcessrate', 'real', 'NULL', '', '', '', # second tax % when non-local
731 'unittype', 'int', 'NULL', '', '', '', # for fee
732 'fee', 'real', 'NULL', '', '', '', # amount tax per unit
733 'excessfee', 'real', 'NULL', '', '', '', # second amount tax per unit
734 'feebase', 'real', 'NULL', '', '', '', # units taxed at first rate
735 'feemax', 'real', 'NULL', '', '', '', # maximum number of unit taxed
736 'maxtype', 'int', 'NULL', '', '', '', # indicator of how thresholds accumulate
737 'taxname', 'varchar', 'NULL', $char_d, '', '', # may appear on invoice
738 'taxauth', 'int', 'NULL', '', '', '', # tax authority
739 'basetype', 'int', 'NULL', '', '', '', # indicator of basis for tax
740 'passtype', 'int', 'NULL', '', '', '', # indicator declaring how item should be shown
741 'passflag', 'char', 'NULL', 1, '', '', # Y = required to list as line item, N = Prohibited
742 'setuptax', 'char', 'NULL', 1, '', '', # Y = setup tax exempt
743 'recurtax', 'char', 'NULL', 1, '', '', # Y = recur tax exempt
744 'manual', 'char', 'NULL', 1, '', '', # Y = manually edited
745 'disabled', 'char', 'NULL', 1, '', '', # Y = tax disabled
747 'primary_key' => 'taxnum',
749 'index' => [ ['taxclassnum'], ['data_vendor', 'geocode'] ],
752 'cust_tax_location' => {
754 'custlocationnum', 'serial', '', '', '', '',
755 'data_vendor', 'varchar', 'NULL', $char_d, '', '', # update source
756 'zip', 'char', '', 5, '', '',
757 'state', 'char', '', 2, '', '',
758 'plus4hi', 'char', '', 4, '', '',
759 'plus4lo', 'char', '', 4, '', '',
760 'default_location','char', 'NULL', 1, '', '', # Y = default for zip
761 'geocode', 'varchar', '', 20, '', '',
763 'primary_key' => 'custlocationnum',
765 'index' => [ [ 'zip', 'plus4lo', 'plus4hi' ] ],
770 'taxclassnum', 'serial', '', '', '', '',
771 'data_vendor', 'varchar', 'NULL', $char_d, '', '',
772 'taxclass', 'varchar', '', $char_d, '', '',
773 'description', 'varchar', '', 2*$char_d, '', '',
775 'primary_key' => 'taxclassnum',
776 'unique' => [ [ 'data_vendor', 'taxclass' ] ],
780 'cust_pay_pending' => {
782 'paypendingnum','serial', '', '', '', '',
783 'custnum', 'int', '', '', '', '',
784 'paid', @money_type, '', '',
785 '_date', @date_type, '', '',
786 'payby', 'char', '', 4, '', '', #CARD/BILL/COMP, should
787 # be index into payby
789 'payinfo', 'varchar', 'NULL', 512, '', '', #see cust_main above
790 'paymask', 'varchar', 'NULL', $char_d, '', '',
791 'paydate', 'varchar', 'NULL', 10, '', '',
792 #'paybatch', 'varchar', 'NULL', $char_d, '', '', #for auditing purposes.
793 'payunique', 'varchar', 'NULL', $char_d, '', '', #separate paybatch "unique" functions from current usage
795 'status', 'varchar', '', $char_d, '', '',
796 'statustext', 'text', 'NULL', '', '', '',
797 'gatewaynum', 'int', 'NULL', '', '', '',
798 #'cust_balance', @money_type, '', '',
799 'paynum', 'int', 'NULL', '', '', '',
801 'primary_key' => 'paypendingnum',
802 'unique' => [ [ 'payunique' ] ],
803 'index' => [ [ 'custnum' ], [ 'status' ], ],
808 'paynum', 'serial', '', '', '', '',
809 'custnum', 'int', '', '', '', '',
810 '_date', @date_type, '', '',
811 'paid', @money_type, '', '',
812 'otaker', 'varchar', 'NULL', 32, '', '', #NULL for the upgrade so we can create & populate the field
813 'payby', 'char', '', 4, '', '', # CARD/BILL/COMP, should be
814 # index into payby table
816 'payinfo', 'varchar', 'NULL', 512, '', '', #see cust_main above
817 'paymask', 'varchar', 'NULL', $char_d, '', '',
818 'paydate', 'varchar', 'NULL', 10, '', '',
819 'paybatch', 'varchar', 'NULL', $char_d, '', '', #for auditing purposes.
820 'payunique', 'varchar', 'NULL', $char_d, '', '', #separate paybatch "unique" functions from current usage
821 'closed', 'char', 'NULL', 1, '', '',
823 'primary_key' => 'paynum',
824 #i guess not now, with cust_pay_pending, if we actually make it here, we _do_ want to record it# 'unique' => [ [ 'payunique' ] ],
825 'index' => [ [ 'custnum' ], [ 'paybatch' ], [ 'payby' ], [ '_date' ] ],
830 'paynum', 'int', '', '', '', '',
831 'custnum', 'int', '', '', '', '',
832 'paid', @money_type, '', '',
833 '_date', @date_type, '', '',
834 'payby', 'char', '', 4, '', '', # CARD/BILL/COMP, should be
835 # index into payby table
837 'payinfo', 'varchar', 'NULL', 512, '', '', #see cust_main above
838 'paymask', 'varchar', 'NULL', $char_d, '', '',
839 'paybatch', 'varchar', 'NULL', $char_d, '', '', #for auditing purposes.
840 'closed', 'char', 'NULL', 1, '', '',
841 'void_date', @date_type, '', '',
842 'reason', 'varchar', 'NULL', $char_d, '', '',
843 'otaker', 'varchar', '', 32, '', '',
845 'primary_key' => 'paynum',
847 'index' => [ [ 'custnum' ] ],
852 'billpaynum', 'serial', '', '', '', '',
853 'invnum', 'int', '', '', '', '',
854 'paynum', 'int', '', '', '', '',
855 'amount', @money_type, '', '',
856 '_date', @date_type, '', '',
858 'primary_key' => 'billpaynum',
860 'index' => [ [ 'paynum' ], [ 'invnum' ] ],
863 'cust_bill_pay_batch' => {
865 'billpaynum', 'serial', '', '', '', '',
866 'invnum', 'int', '', '', '', '',
867 'paybatchnum', 'int', '', '', '', '',
868 'amount', @money_type, '', '',
869 '_date', @date_type, '', '',
871 'primary_key' => 'billpaynum',
873 'index' => [ [ 'paybatchnum' ], [ 'invnum' ] ],
876 'cust_bill_pay_pkg' => {
878 'billpaypkgnum', 'serial', '', '', '', '',
879 'billpaynum', 'int', '', '', '', '',
880 'billpkgnum', 'int', '', '', '', '',
881 'amount', @money_type, '', '',
882 'setuprecur', 'varchar', '', $char_d, '', '',
883 'sdate', @date_type, '', '',
884 'edate', @date_type, '', '',
886 'primary_key' => 'billpaypkgnum',
888 'index' => [ [ 'billpaynum' ], [ 'billpkgnum' ], ],
891 'pay_batch' => { #batches of payments to an external processor
893 'batchnum', 'serial', '', '', '', '',
894 'payby', 'char', '', 4, '', '', # CARD/CHEK
895 'status', 'char', 'NULL', 1, '', '',
896 'download', @date_type, '', '',
897 'upload', @date_type, '', '',
899 'primary_key' => 'batchnum',
904 'cust_pay_batch' => { #what's this used for again? list of customers
905 #in current CARD batch? (necessarily CARD?)
907 'paybatchnum', 'serial', '', '', '', '',
908 'batchnum', 'int', '', '', '', '',
909 'invnum', 'int', '', '', '', '',
910 'custnum', 'int', '', '', '', '',
911 'last', 'varchar', '', $char_d, '', '',
912 'first', 'varchar', '', $char_d, '', '',
913 'address1', 'varchar', '', $char_d, '', '',
914 'address2', 'varchar', 'NULL', $char_d, '', '',
915 'city', 'varchar', '', $char_d, '', '',
916 'state', 'varchar', 'NULL', $char_d, '', '',
917 'zip', 'varchar', 'NULL', 10, '', '',
918 'country', 'char', '', 2, '', '',
919 # 'trancode', 'int', '', '', '', ''
920 'payby', 'char', '', 4, '', '', # CARD/BILL/COMP, should be
921 'payinfo', 'varchar', '', 512, '', '',
922 #'exp', @date_type, '', ''
923 'exp', 'varchar', 'NULL', 11, '', '',
924 'payname', 'varchar', 'NULL', $char_d, '', '',
925 'amount', @money_type, '', '',
926 'status', 'varchar', 'NULL', $char_d, '', '',
928 'primary_key' => 'paybatchnum',
930 'index' => [ ['batchnum'], ['invnum'], ['custnum'] ],
935 'pkgnum', 'serial', '', '', '', '',
936 'custnum', 'int', '', '', '', '',
937 'pkgpart', 'int', '', '', '', '',
938 'otaker', 'varchar', '', 32, '', '',
939 'setup', @date_type, '', '',
940 'bill', @date_type, '', '',
941 'last_bill', @date_type, '', '',
942 'susp', @date_type, '', '',
943 'adjourn', @date_type, '', '',
944 'cancel', @date_type, '', '',
945 'expire', @date_type, '', '',
946 'change_date', @date_type, '', '',
947 'change_pkgnum', 'int', 'NULL', '', '', '',
948 'change_pkgpart', 'int', 'NULL', '', '', '',
949 'manual_flag', 'char', 'NULL', 1, '', '',
950 'quantity', 'int', 'NULL', '', '', '',
952 'primary_key' => 'pkgnum',
954 'index' => [ ['custnum'], ['pkgpart'],
955 ['setup'], ['last_bill'], ['bill'], ['susp'], ['adjourn'],
956 ['expire'], ['cancel'],
961 'cust_pkg_option' => {
963 'optionnum', 'serial', '', '', '', '',
964 'pkgnum', 'int', '', '', '', '',
965 'optionname', 'varchar', '', $char_d, '', '',
966 'optionvalue', 'text', 'NULL', '', '', '',
968 'primary_key' => 'optionnum',
970 'index' => [ [ 'pkgnum' ], [ 'optionname' ] ],
973 'cust_pkg_detail' => {
975 'pkgdetailnum', 'serial', '', '', '', '',
976 'pkgnum', 'int', '', '', '', '',
977 'detail', 'varchar', '', $char_d, '', '',
978 'detailtype', 'char', '', 1, '', '', # "I"nvoice or "C"omment
979 'weight', 'int', '', '', '', '',
981 'primary_key' => 'pkgdetailnum',
983 'index' => [ [ 'pkgnum', 'detailtype' ] ],
986 'cust_pkg_reason' => {
988 'num', 'serial', '', '', '', '',
989 'pkgnum', 'int', '', '', '', '',
990 'reasonnum','int', '', '', '', '',
991 'action', 'char', 'NULL', 1, '', '', #should not be nullable
992 'otaker', 'varchar', '', 32, '', '',
993 'date', @date_type, '', '',
995 'primary_key' => 'num',
997 'index' => [ [ 'pkgnum' ], [ 'reasonnum' ], ['action'], ],
1002 'refundnum', 'serial', '', '', '', '',
1003 'custnum', 'int', '', '', '', '',
1004 '_date', @date_type, '', '',
1005 'refund', @money_type, '', '',
1006 'otaker', 'varchar', '', 32, '', '',
1007 'reason', 'varchar', '', $char_d, '', '',
1008 'payby', 'char', '', 4, '', '', # CARD/BILL/COMP, should
1009 # be index into payby
1011 'payinfo', 'varchar', 'NULL', 512, '', '', #see cust_main above
1012 'paymask', 'varchar', 'NULL', $char_d, '', '',
1013 'paybatch', 'varchar', 'NULL', $char_d, '', '',
1014 'closed', 'char', 'NULL', 1, '', '',
1016 'primary_key' => 'refundnum',
1018 'index' => [ ['custnum'], ['_date'] ],
1021 'cust_credit_refund' => {
1023 'creditrefundnum', 'serial', '', '', '', '',
1024 'crednum', 'int', '', '', '', '',
1025 'refundnum', 'int', '', '', '', '',
1026 'amount', @money_type, '', '',
1027 '_date', @date_type, '', '',
1029 'primary_key' => 'creditrefundnum',
1031 'index' => [ ['crednum'], ['refundnum'] ],
1037 'svcnum', 'serial', '', '', '', '',
1038 'pkgnum', 'int', 'NULL', '', '', '',
1039 'svcpart', 'int', '', '', '', '',
1040 'overlimit', @date_type, '', '',
1042 'primary_key' => 'svcnum',
1044 'index' => [ ['svcnum'], ['pkgnum'], ['svcpart'] ],
1047 'cust_svc_option' => {
1049 'optionnum', 'serial', '', '', '', '',
1050 'svcnum', 'int', '', '', '', '',
1051 'optionname', 'varchar', '', $char_d, '', '',
1052 'optionvalue', 'text', 'NULL', '', '', '',
1054 'primary_key' => 'optionnum',
1056 'index' => [ [ 'svcnum' ], [ 'optionname' ] ],
1061 'pkgpart', 'serial', '', '', '', '',
1062 'pkg', 'varchar', '', $char_d, '', '',
1063 'comment', 'varchar', '', $char_d, '', '',
1064 'promo_code', 'varchar', 'NULL', $char_d, '', '',
1065 'setup', @perl_type, '', '',
1066 'freq', 'varchar', '', $char_d, '', '', #billing frequency
1067 'recur', @perl_type, '', '',
1068 'setuptax', 'char', 'NULL', 1, '', '',
1069 'recurtax', 'char', 'NULL', 1, '', '',
1070 'plan', 'varchar', 'NULL', $char_d, '', '',
1071 'plandata', 'text', 'NULL', '', '', '',
1072 'disabled', 'char', 'NULL', 1, '', '',
1073 'taxclass', 'varchar', 'NULL', $char_d, '', '',
1074 'classnum', 'int', 'NULL', '', '', '',
1075 'taxproductnum', 'int', 'NULL', '', '', '',
1076 'pay_weight', 'real', 'NULL', '', '', '',
1077 'credit_weight', 'real', 'NULL', '', '', '',
1078 'agentnum', 'int', 'NULL', '', '', '',
1081 'primary_key' => 'pkgpart',
1083 'index' => [ [ 'promo_code' ], [ 'disabled' ], [ 'agentnum' ], ],
1086 'part_pkg_link' => {
1088 'pkglinknum', 'serial', '', '', '', '',
1089 'src_pkgpart', 'int', '', '', '', '',
1090 'dst_pkgpart', 'int', '', '', '', '',
1091 'link_type', 'varchar', '', $char_d, '', '',
1093 'primary_key' => 'pkglinknum',
1094 'unique' => [ [ 'src_pkgpart', 'dst_pkgpart', 'link_type' ] ],
1095 'index' => [ [ 'src_pkgpart' ] ],
1098 'part_pkg_taxclass' => {
1100 'taxclassnum', 'serial', '', '', '', '',
1101 'taxclass', 'varchar', '', $char_d, '', '',
1103 'primary_key' => 'taxclassnum',
1104 'unique' => [ [ 'taxclass' ] ],
1108 'part_pkg_taxproduct' => {
1110 'taxproductnum', 'serial', '', '', '', '',
1111 'data_vendor', 'varchar', 'NULL', $char_d, '', '',
1112 'taxproduct', 'varchar', '', $char_d, '', '',
1113 'description', 'varchar', '', 2*$char_d, '', '',
1115 'primary_key' => 'taxproductnum',
1116 'unique' => [ [ 'data_vendor', 'taxproduct' ] ],
1120 'part_pkg_taxrate' => {
1122 'pkgtaxratenum', 'serial', '', '', '', '',
1123 'data_vendor', 'varchar', 'NULL', $char_d, '', '', # update source
1124 'geocode', 'varchar', 'NULL', $char_d, '', '', # cch provides 10
1125 'taxproductnum', 'int', '', '', '', '',
1126 'city', 'varchar', 'NULL', $char_d, '', '', # tax_location?
1127 'county', 'varchar', 'NULL', $char_d, '', '',
1128 'state', 'varchar', 'NULL', $char_d, '', '',
1129 'local', 'varchar', 'NULL', $char_d, '', '',
1130 'country', 'char', 'NULL', 2, '', '',
1131 'taxclassnumtaxed', 'int', 'NULL', '', '', '',
1132 'taxcattaxed', 'varchar', 'NULL', $char_d, '', '',
1133 'taxclassnum', 'int', 'NULL', '', '', '',
1134 'effdate', @date_type, '', '',
1135 'taxable', 'char', 'NULL', 1, '', '',
1137 'primary_key' => 'pkgtaxratenum',
1139 'index' => [ [ 'data_vendor', 'geocode', 'taxproductnum' ] ],
1142 'part_pkg_taxoverride' => {
1144 'taxoverridenum', 'serial', '', '', '', '',
1145 'pkgpart', 'serial', '', '', '', '',
1146 'taxclassnum', 'serial', '', '', '', '',
1147 'usage_class', 'varchar', 'NULL', $char_d, '', '',
1149 'primary_key' => 'taxoverridenum',
1151 'index' => [ [ 'pkgpart' ], [ 'taxclassnum' ] ],
1156 # 'titlenum', 'int', '', '',
1157 # 'title', 'varchar', '', $char_d,
1159 # 'primary_key' => 'titlenum',
1160 # 'unique' => [ [] ],
1161 # 'index' => [ [] ],
1166 'pkgsvcnum', 'serial', '', '', '', '',
1167 'pkgpart', 'int', '', '', '', '',
1168 'svcpart', 'int', '', '', '', '',
1169 'quantity', 'int', '', '', '', '',
1170 'primary_svc','char', 'NULL', 1, '', '',
1172 'primary_key' => 'pkgsvcnum',
1173 'unique' => [ ['pkgpart', 'svcpart'] ],
1174 'index' => [ ['pkgpart'] ],
1177 'part_referral' => {
1179 'refnum', 'serial', '', '', '', '',
1180 'referral', 'varchar', '', $char_d, '', '',
1181 'disabled', 'char', 'NULL', 1, '', '',
1182 'agentnum', 'int', 'NULL', '', '', '',
1184 'primary_key' => 'refnum',
1186 'index' => [ ['disabled'], ['agentnum'], ],
1191 'svcpart', 'serial', '', '', '', '',
1192 'svc', 'varchar', '', $char_d, '', '',
1193 'svcdb', 'varchar', '', $char_d, '', '',
1194 'disabled', 'char', 'NULL', 1, '', '',
1196 'primary_key' => 'svcpart',
1198 'index' => [ [ 'disabled' ] ],
1201 'part_svc_column' => {
1203 'columnnum', 'serial', '', '', '', '',
1204 'svcpart', 'int', '', '', '', '',
1205 'columnname', 'varchar', '', 64, '', '',
1206 'columnvalue', 'varchar', 'NULL', $char_d, '', '',
1207 'columnflag', 'char', 'NULL', 1, '', '',
1209 'primary_key' => 'columnnum',
1210 'unique' => [ [ 'svcpart', 'columnname' ] ],
1211 'index' => [ [ 'svcpart' ] ],
1214 #(this should be renamed to part_pop)
1217 'popnum', 'serial', '', '', '', '',
1218 'city', 'varchar', '', $char_d, '', '',
1219 'state', 'varchar', '', $char_d, '', '',
1220 'ac', 'char', '', 3, '', '',
1221 'exch', 'char', '', 3, '', '',
1222 'loc', 'char', 'NULL', 4, '', '', #NULL for legacy purposes
1224 'primary_key' => 'popnum',
1226 'index' => [ [ 'state' ] ],
1229 'part_pop_local' => {
1231 'localnum', 'serial', '', '', '', '',
1232 'popnum', 'int', '', '', '', '',
1233 'city', 'varchar', 'NULL', $char_d, '', '',
1234 'state', 'char', 'NULL', 2, '', '',
1235 'npa', 'char', '', 3, '', '',
1236 'nxx', 'char', '', 3, '', '',
1238 'primary_key' => 'localnum',
1240 'index' => [ [ 'npa', 'nxx' ], [ 'popnum' ] ],
1245 'svcnum', 'int', '', '', '', '',
1246 'username', 'varchar', '', $username_len, '', '',
1247 '_password', 'varchar', '', 512, '', '',
1248 '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
1249 'sec_phrase', 'varchar', 'NULL', $char_d, '', '',
1250 'popnum', 'int', 'NULL', '', '', '',
1251 'uid', 'int', 'NULL', '', '', '',
1252 'gid', 'int', 'NULL', '', '', '',
1253 'finger', 'varchar', 'NULL', $char_d, '', '',
1254 'dir', 'varchar', 'NULL', $char_d, '', '',
1255 'shell', 'varchar', 'NULL', $char_d, '', '',
1256 'quota', 'varchar', 'NULL', $char_d, '', '',
1257 'slipip', 'varchar', 'NULL', 15, '', '', #four TINYINTs, bah.
1258 'seconds', 'int', 'NULL', '', '', '', #uhhhh
1259 'seconds_threshold', 'int', 'NULL', '', '', '',
1260 'upbytes', 'bigint', 'NULL', '', '', '',
1261 'upbytes_threshold', 'bigint', 'NULL', '', '', '',
1262 'downbytes', 'bigint', 'NULL', '', '', '',
1263 'downbytes_threshold', 'bigint', 'NULL', '', '', '',
1264 'totalbytes','bigint', 'NULL', '', '', '',
1265 'totalbytes_threshold', 'bigint', 'NULL', '', '', '',
1266 'domsvc', 'int', '', '', '', '',
1267 'last_login', @date_type, '', '',
1268 'last_logout', @date_type, '', '',
1270 'primary_key' => 'svcnum',
1271 #'unique' => [ [ 'username', 'domsvc' ] ],
1273 'index' => [ ['username'], ['domsvc'] ],
1276 'acct_rt_transaction' => {
1278 'svcrtid', 'int', '', '', '', '',
1279 'svcnum', 'int', '', '', '', '',
1280 'transaction_id', 'int', '', '', '', '',
1281 '_date', @date_type, '', '',
1282 'seconds', 'int', '', '', '', '', #uhhhh
1283 'support', 'int', '', '', '', '',
1285 'primary_key' => 'svcrtid',
1287 'index' => [ ['svcnum', 'transaction_id'] ],
1292 # 'svcnum', 'int', '', '',
1293 # 'amount', @money_type,
1295 # 'primary_key' => 'svcnum',
1296 # 'unique' => [ [] ],
1297 # 'index' => [ [] ],
1302 'svcnum', 'int', '', '', '', '',
1303 'domain', 'varchar', '', $char_d, '', '',
1304 'suffix', 'varchar', 'NULL', $char_d, '', '',
1305 'catchall', 'int', 'NULL', '', '', '',
1306 'parent_svcnum', 'int', 'NULL', '', '', '',
1307 'registrarnum', 'int', 'NULL', '', '', '',
1308 'registrarkey', 'varchar', 'NULL', 512, '', '',
1309 'setup_date', @date_type, '', '',
1310 'renewal_interval', 'int', 'NULL', '', '', '',
1311 'expiration_date', @date_type, '', '',
1313 'primary_key' => 'svcnum',
1315 'index' => [ ['domain'] ],
1318 'domain_record' => {
1320 'recnum', 'serial', '', '', '', '',
1321 'svcnum', 'int', '', '', '', '',
1322 'reczone', 'varchar', '', 255, '', '',
1323 'recaf', 'char', '', 2, '', '',
1324 'rectype', 'varchar', '', 5, '', '',
1325 'recdata', 'varchar', '', 255, '', '',
1327 'primary_key' => 'recnum',
1329 'index' => [ ['svcnum'] ],
1334 'registrarnum', 'serial', '', '', '', '',
1335 'registrarname', 'varchar', '', $char_d, '', '',
1337 'primary_key' => 'registrarnum',
1344 'svcnum', 'int', '', '', '', '',
1345 'srcsvc', 'int', 'NULL', '', '', '',
1346 'src', 'varchar', 'NULL', 255, '', '',
1347 'dstsvc', 'int', 'NULL', '', '', '',
1348 'dst', 'varchar', 'NULL', 255, '', '',
1350 'primary_key' => 'svcnum',
1352 'index' => [ ['srcsvc'], ['dstsvc'] ],
1357 'svcnum', 'int', '', '', '', '',
1358 'recnum', 'int', '', '', '', '',
1359 'usersvc', 'int', 'NULL', '', '', '',
1360 'config', 'text', 'NULL', '', '', '',
1362 'primary_key' => 'svcnum',
1369 # 'svcnum', 'int', '', '',
1370 # 'svcnum', 'int', '', '',
1371 # 'svcnum', 'int', '', '',
1372 # 'worker', 'varchar', '', $char_d,
1373 # '_date', @date_type,
1375 # 'primary_key' => 'svcnum',
1376 # 'unique' => [ [] ],
1377 # 'index' => [ [] ],
1380 'prepay_credit' => {
1382 'prepaynum', 'serial', '', '', '', '',
1383 'identifier', 'varchar', '', $char_d, '', '',
1384 'amount', @money_type, '', '',
1385 'seconds', 'int', 'NULL', '', '', '',
1386 'upbytes', 'bigint', 'NULL', '', '', '',
1387 'downbytes', 'bigint', 'NULL', '', '', '',
1388 'totalbytes', 'bigint', 'NULL', '', '', '',
1389 'agentnum', 'int', 'NULL', '', '', '',
1391 'primary_key' => 'prepaynum',
1392 'unique' => [ ['identifier'] ],
1398 'portnum', 'serial', '', '', '', '',
1399 'ip', 'varchar', 'NULL', 15, '', '',
1400 'nasport', 'int', 'NULL', '', '', '',
1401 'nasnum', 'int', '', '', '', '',
1403 'primary_key' => 'portnum',
1410 'nasnum', 'serial', '', '', '', '',
1411 'nas', 'varchar', '', $char_d, '', '',
1412 'nasip', 'varchar', '', 15, '', '',
1413 'nasfqdn', 'varchar', '', $char_d, '', '',
1414 'last', 'int', '', '', '', '',
1416 'primary_key' => 'nasnum',
1417 'unique' => [ [ 'nas' ], [ 'nasip' ] ],
1418 'index' => [ [ 'last' ] ],
1423 # 'sessionnum', 'serial', '', '', '', '',
1424 # 'portnum', 'int', '', '', '', '',
1425 # 'svcnum', 'int', '', '', '', '',
1426 # 'login', @date_type, '', '',
1427 # 'logout', @date_type, '', '',
1429 # 'primary_key' => 'sessionnum',
1431 # 'index' => [ [ 'portnum' ] ],
1436 'jobnum', 'serial', '', '', '', '',
1437 'job', 'text', '', '', '', '',
1438 '_date', 'int', '', '', '', '',
1439 'status', 'varchar', '', $char_d, '', '',
1440 'statustext', 'text', 'NULL', '', '', '',
1441 'svcnum', 'int', 'NULL', '', '', '',
1442 'secure', 'char', 'NULL', 1, '', '', # Y = needs to be run on machine
1445 'primary_key' => 'jobnum',
1447 'index' => [ [ 'svcnum' ], [ 'status' ] ],
1452 'argnum', 'serial', '', '', '', '',
1453 'jobnum', 'int', '', '', '', '',
1454 'arg', 'text', 'NULL', '', '', '',
1456 'primary_key' => 'argnum',
1458 'index' => [ [ 'jobnum' ] ],
1463 'dependnum', 'serial', '', '', '', '',
1464 'jobnum', 'int', '', '', '', '',
1465 'depend_jobnum', 'int', '', '', '', '',
1467 'primary_key' => 'dependnum',
1469 'index' => [ [ 'jobnum' ], [ 'depend_jobnum' ] ],
1474 'exportsvcnum' => 'serial', '', '', '', '',
1475 'exportnum' => 'int', '', '', '', '',
1476 'svcpart' => 'int', '', '', '', '',
1478 'primary_key' => 'exportsvcnum',
1479 'unique' => [ [ 'exportnum', 'svcpart' ] ],
1480 'index' => [ [ 'exportnum' ], [ 'svcpart' ] ],
1485 'exportnum', 'serial', '', '', '', '',
1486 'machine', 'varchar', '', $char_d, '', '',
1487 'exporttype', 'varchar', '', $char_d, '', '',
1488 'nodomain', 'char', 'NULL', 1, '', '',
1490 'primary_key' => 'exportnum',
1492 'index' => [ [ 'machine' ], [ 'exporttype' ] ],
1495 'part_export_option' => {
1497 'optionnum', 'serial', '', '', '', '',
1498 'exportnum', 'int', '', '', '', '',
1499 'optionname', 'varchar', '', $char_d, '', '',
1500 'optionvalue', 'text', 'NULL', '', '', '',
1502 'primary_key' => 'optionnum',
1504 'index' => [ [ 'exportnum' ], [ 'optionname' ] ],
1507 'radius_usergroup' => {
1509 'usergroupnum', 'serial', '', '', '', '',
1510 'svcnum', 'int', '', '', '', '',
1511 'groupname', 'varchar', '', $char_d, '', '',
1513 'primary_key' => 'usergroupnum',
1515 'index' => [ [ 'svcnum' ], [ 'groupname' ] ],
1520 'msgnum', 'serial', '', '', '', '',
1521 'msgcode', 'varchar', '', $char_d, '', '',
1522 'locale', 'varchar', '', 16, '', '',
1523 'msg', 'text', '', '', '', '',
1525 'primary_key' => 'msgnum',
1526 'unique' => [ [ 'msgcode', 'locale' ] ],
1530 'cust_tax_exempt' => {
1532 'exemptnum', 'serial', '', '', '', '',
1533 'custnum', 'int', '', '', '', '',
1534 'taxnum', 'int', '', '', '', '',
1535 'year', 'int', '', '', '', '',
1536 'month', 'int', '', '', '', '',
1537 'amount', @money_type, '', '',
1539 'primary_key' => 'exemptnum',
1540 'unique' => [ [ 'custnum', 'taxnum', 'year', 'month' ] ],
1544 'cust_tax_exempt_pkg' => {
1546 'exemptpkgnum', 'serial', '', '', '', '',
1547 #'custnum', 'int', '', '', '', ''
1548 'billpkgnum', 'int', '', '', '', '',
1549 'taxnum', 'int', '', '', '', '',
1550 'year', 'int', '', '', '', '',
1551 'month', 'int', '', '', '', '',
1552 'amount', @money_type, '', '',
1554 'primary_key' => 'exemptpkgnum',
1556 'index' => [ [ 'taxnum', 'year', 'month' ],
1564 'routernum', 'serial', '', '', '', '',
1565 'routername', 'varchar', '', $char_d, '', '',
1566 'svcnum', 'int', 'NULL', '', '', '',
1567 'agentnum', 'int', 'NULL', '', '', '',
1569 'primary_key' => 'routernum',
1574 'part_svc_router' => {
1576 'svcrouternum', 'serial', '', '', '', '',
1577 'svcpart', 'int', '', '', '', '',
1578 'routernum', 'int', '', '', '', '',
1580 'primary_key' => 'svcrouternum',
1587 'blocknum', 'serial', '', '', '', '',
1588 'routernum', 'int', '', '', '', '',
1589 'ip_gateway', 'varchar', '', 15, '', '',
1590 'ip_netmask', 'int', '', '', '', '',
1591 'agentnum', 'int', 'NULL', '', '', '',
1592 'manual_flag', 'char', 'NULL', 1, '', '',
1594 'primary_key' => 'blocknum',
1595 'unique' => [ [ 'blocknum', 'routernum' ] ],
1599 'svc_broadband' => {
1601 'svcnum', 'int', '', '', '', '',
1602 'description', 'varchar', 'NULL', $char_d, '', '',
1603 'blocknum', 'int', '', '', '', '',
1604 'speed_up', 'int', '', '', '', '',
1605 'speed_down', 'int', '', '', '', '',
1606 'ip_addr', 'varchar', '', 15, '', '',
1607 'mac_addr', 'varchar', 'NULL', 12, '', '',
1608 'authkey', 'varchar', 'NULL', 32, '', '',
1609 'latitude', 'decimal', 'NULL', '', '', '',
1610 'longitude', 'decimal', 'NULL', '', '', '',
1611 'altitude', 'decimal', 'NULL', '', '', '',
1612 'vlan_profile', 'varchar', 'NULL', $char_d, '', '',
1614 'primary_key' => 'svcnum',
1619 'part_virtual_field' => {
1621 'vfieldpart', 'serial', '', '', '', '',
1622 'dbtable', 'varchar', '', 32, '', '',
1623 'name', 'varchar', '', 32, '', '',
1624 'check_block', 'text', 'NULL', '', '', '',
1625 'length', 'int', 'NULL', '', '', '',
1626 'list_source', 'text', 'NULL', '', '', '',
1627 'label', 'varchar', 'NULL', 80, '', '',
1629 'primary_key' => 'vfieldpart',
1634 'virtual_field' => {
1636 'vfieldnum', 'serial', '', '', '', '',
1637 'recnum', 'int', '', '', '', '',
1638 'vfieldpart', 'int', '', '', '', '',
1639 'value', 'varchar', '', 128, '', '',
1641 'primary_key' => 'vfieldnum',
1642 'unique' => [ [ 'vfieldpart', 'recnum' ] ],
1648 'snarfnum', 'int', '', '', '', '',
1649 'svcnum', 'int', '', '', '', '',
1650 'machine', 'varchar', '', 255, '', '',
1651 'protocol', 'varchar', '', $char_d, '', '',
1652 'username', 'varchar', '', $char_d, '', '',
1653 '_password', 'varchar', '', $char_d, '', '',
1655 'primary_key' => 'snarfnum',
1657 'index' => [ [ 'svcnum' ] ],
1662 'svcnum', 'int', '', '', '', '',
1663 'id', 'int', 'NULL', '', '', '',
1664 'title', 'varchar', 'NULL', $char_d, '', '',
1666 'primary_key' => 'svcnum',
1671 'cust_pay_refund' => {
1673 'payrefundnum', 'serial', '', '', '', '',
1674 'paynum', 'int', '', '', '', '',
1675 'refundnum', 'int', '', '', '', '',
1676 '_date', @date_type, '', '',
1677 'amount', @money_type, '', '',
1679 'primary_key' => 'payrefundnum',
1681 'index' => [ ['paynum'], ['refundnum'] ],
1684 'part_pkg_option' => {
1686 'optionnum', 'serial', '', '', '', '',
1687 'pkgpart', 'int', '', '', '', '',
1688 'optionname', 'varchar', '', $char_d, '', '',
1689 'optionvalue', 'text', 'NULL', '', '', '',
1691 'primary_key' => 'optionnum',
1693 'index' => [ [ 'pkgpart' ], [ 'optionname' ] ],
1698 'ratenum', 'serial', '', '', '', '',
1699 'ratename', 'varchar', '', $char_d, '', '',
1701 'primary_key' => 'ratenum',
1708 'ratedetailnum', 'serial', '', '', '', '',
1709 'ratenum', 'int', '', '', '', '',
1710 'orig_regionnum', 'int', 'NULL', '', '', '',
1711 'dest_regionnum', 'int', '', '', '', '',
1712 'min_included', 'int', '', '', '', '',
1713 #'min_charge', @money_type, '', '',
1714 'min_charge', 'decimal', '', '10,5', '', '',
1715 'sec_granularity', 'int', '', '', '', '',
1716 #time period (link to table of periods)?
1717 'classnum', 'int', 'NULL', '', '', '',
1719 'primary_key' => 'ratedetailnum',
1720 'unique' => [ [ 'ratenum', 'orig_regionnum', 'dest_regionnum' ] ],
1721 'index' => [ [ 'ratenum', 'dest_regionnum' ] ],
1726 'regionnum', 'serial', '', '', '', '',
1727 'regionname', 'varchar', '', $char_d, '', '',
1729 'primary_key' => 'regionnum',
1736 'prefixnum', 'serial', '', '', '', '',
1737 'regionnum', 'int', '', '',, '', '',
1738 'countrycode', 'varchar', '', 3, '', '',
1739 'npa', 'varchar', 'NULL', 6, '', '',
1740 'nxx', 'varchar', 'NULL', 3, '', '',
1742 'primary_key' => 'prefixnum',
1744 'index' => [ [ 'countrycode' ], [ 'regionnum' ] ],
1749 'classnum', 'serial', '', '', '', '',
1750 'classname', 'varchar', '', $char_d, '', '',
1751 'disabled', 'char', 'NULL', 1, '', '',
1753 'primary_key' => 'classnum',
1755 'index' => [ ['disabled'] ],
1760 'codenum', 'serial', '', '', '', '',
1761 'code', 'varchar', '', $char_d, '', '',
1762 'agentnum', 'int', '', '', '', '',
1764 'primary_key' => 'codenum',
1765 'unique' => [ [ 'agentnum', 'code' ] ],
1766 'index' => [ [ 'agentnum' ] ],
1771 'codepkgnum', 'serial', '', '', '', '',
1772 'codenum', 'int', '', '', '', '',
1773 'pkgpart', 'int', '', '', '', '',
1775 'primary_key' => 'codepkgnum',
1776 'unique' => [ [ 'codenum', 'pkgpart' ] ],
1777 'index' => [ [ 'codenum' ] ],
1780 'clientapi_session' => {
1782 'sessionnum', 'serial', '', '', '', '',
1783 'sessionid', 'varchar', '', $char_d, '', '',
1784 'namespace', 'varchar', '', $char_d, '', '',
1786 'primary_key' => 'sessionnum',
1787 'unique' => [ [ 'sessionid', 'namespace' ] ],
1791 'clientapi_session_field' => {
1793 'fieldnum', 'serial', '', '', '', '',
1794 'sessionnum', 'int', '', '', '', '',
1795 'fieldname', 'varchar', '', $char_d, '', '',
1796 'fieldvalue', 'text', 'NULL', '', '', '',
1798 'primary_key' => 'fieldnum',
1799 'unique' => [ [ 'sessionnum', 'fieldname' ] ],
1803 'payment_gateway' => {
1805 'gatewaynum', 'serial', '', '', '', '',
1806 'gateway_module', 'varchar', '', $char_d, '', '',
1807 'gateway_username', 'varchar', 'NULL', $char_d, '', '',
1808 'gateway_password', 'varchar', 'NULL', $char_d, '', '',
1809 'gateway_action', 'varchar', 'NULL', $char_d, '', '',
1810 'disabled', 'char', 'NULL', 1, '', '',
1812 'primary_key' => 'gatewaynum',
1814 'index' => [ [ 'disabled' ] ],
1817 'payment_gateway_option' => {
1819 'optionnum', 'serial', '', '', '', '',
1820 'gatewaynum', 'int', '', '', '', '',
1821 'optionname', 'varchar', '', $char_d, '', '',
1822 'optionvalue', 'text', 'NULL', '', '', '',
1824 'primary_key' => 'optionnum',
1826 'index' => [ [ 'gatewaynum' ], [ 'optionname' ] ],
1829 'agent_payment_gateway' => {
1831 'agentgatewaynum', 'serial', '', '', '', '',
1832 'agentnum', 'int', '', '', '', '',
1833 'gatewaynum', 'int', '', '', '', '',
1834 'cardtype', 'varchar', 'NULL', $char_d, '', '',
1835 'taxclass', 'varchar', 'NULL', $char_d, '', '',
1837 'primary_key' => 'agentgatewaynum',
1839 'index' => [ [ 'agentnum', 'cardtype' ], ],
1844 'bannum', 'serial', '', '', '', '',
1845 'payby', 'char', '', 4, '', '',
1846 'payinfo', 'varchar', '', 128, '', '', #say, a 512-big digest _hex encoded
1847 #'paymask', 'varchar', 'NULL', $char_d, '', ''
1848 '_date', @date_type, '', '',
1849 'otaker', 'varchar', '', 32, '', '',
1850 'reason', 'varchar', 'NULL', $char_d, '', '',
1852 'primary_key' => 'bannum',
1853 'unique' => [ [ 'payby', 'payinfo' ] ],
1859 'categorynum', 'serial', '', '', '', '',
1860 'categoryname', 'varchar', '', $char_d, '', '',
1861 'disabled', 'char', 'NULL', 1, '', '',
1863 'primary_key' => 'categorynum',
1865 'index' => [ ['disabled'] ],
1870 'classnum', 'serial', '', '', '', '',
1871 'classname', 'varchar', '', $char_d, '', '',
1872 'categorynum', 'int', 'NULL', '', '', '',
1873 'disabled', 'char', 'NULL', 1, '', '',
1875 'primary_key' => 'classnum',
1877 'index' => [ ['disabled'] ],
1882 # qw( name type null length default local );
1888 'acctid', 'bigserial', '', '', '', '',
1889 #'calldate', 'TIMESTAMP with time zone', '', '', \'now()', '',
1890 'calldate', 'timestamp', '', '', \'now()', '',
1891 'clid', 'varchar', '', $char_d, \"''", '',
1892 'src', 'varchar', '', $char_d, \"''", '',
1893 'dst', 'varchar', '', $char_d, \"''", '',
1894 'dcontext', 'varchar', '', $char_d, \"''", '',
1895 'channel', 'varchar', '', $char_d, \"''", '',
1896 'dstchannel', 'varchar', '', $char_d, \"''", '',
1897 'lastapp', 'varchar', '', $char_d, \"''", '',
1898 'lastdata', 'varchar', '', $char_d, \"''", '',
1900 #these don't seem to be logged by most of the SQL cdr_* modules
1901 #except tds under sql-illegal names, so;
1902 # ... don't rely on them for rating?
1903 # and, what they hey, i went ahead and changed the names and data types
1904 # to freeside-style dates...
1905 #'start', 'timestamp', 'NULL', '', '', '',
1906 #'answer', 'timestamp', 'NULL', '', '', '',
1907 #'end', 'timestamp', 'NULL', '', '', '',
1908 'startdate', @date_type, '', '',
1909 'answerdate', @date_type, '', '',
1910 'enddate', @date_type, '', '',
1913 'duration', 'int', '', '', 0, '',
1914 'billsec', 'int', '', '', 0, '',
1915 'disposition', 'varchar', '', 45, \"''", '',
1916 'amaflags', 'int', '', '', 0, '',
1917 'accountcode', 'varchar', '', 20, \"''", '',
1918 'uniqueid', 'varchar', '', 32, \"''", '',
1919 'userfield', 'varchar', '', 255, \"''", '',
1922 # fields for unitel/RSLCOM/convergent that don't map well to asterisk
1926 #cdr_type: Usage = 1, S&E = 7, OC&C = 8
1927 'cdrtypenum', 'int', 'NULL', '', '', '',
1929 'charged_party', 'varchar', 'NULL', $char_d, '', '',
1931 'upstream_currency', 'char', 'NULL', 3, '', '',
1932 'upstream_price', 'decimal', 'NULL', '10,2', '', '',
1933 'upstream_rateplanid', 'int', 'NULL', '', '', '', #?
1935 # how it was rated internally...
1936 'ratedetailnum', 'int', 'NULL', '', '', '',
1937 'rated_price', 'decimal', 'NULL', '10,2', '', '',
1939 'distance', 'decimal', 'NULL', '', '', '',
1940 'islocal', 'int', 'NULL', '', '', '', # '', '', 0, '' instead?
1942 #cdr_calltype: the big list in appendix 2
1943 'calltypenum', 'int', 'NULL', '', '', '',
1945 'description', 'varchar', 'NULL', $char_d, '', '',
1946 'quantity', 'int', 'NULL', '', '', '',
1948 #cdr_carrier: Telstra =1, Optus = 2, RSL COM = 3
1949 'carrierid', 'int', 'NULL', '', '', '',
1951 'upstream_rateid', 'int', 'NULL', '', '', '',
1954 #and now for our own fields
1957 # a svcnum... right..?
1958 'svcnum', 'int', 'NULL', '', '', '',
1960 #NULL, done (or something)
1961 'freesidestatus', 'varchar', 'NULL', 32, '', '',
1963 'cdrbatch', 'varchar', 'NULL', $char_d, '', '',
1966 'primary_key' => 'acctid',
1968 'index' => [ [ 'calldate' ], [ 'dst' ], [ 'accountcode' ], [ 'freesidestatus' ], [ 'cdrbatch' ], ],
1973 'calltypenum', 'serial', '', '', '', '',
1974 'calltypename', 'varchar', '', $char_d, '', '',
1976 'primary_key' => 'calltypenum',
1983 'cdrtypenum' => 'serial', '', '', '', '',
1984 'cdrtypename' => 'varchar', '', $char_d, '', '',
1986 'primary_key' => 'cdrtypenum',
1993 'carrierid' => 'serial', '', '', '', '',
1994 'carriername' => 'varchar', '', $char_d, '', '',
1996 'primary_key' => 'carrierid',
2001 #map upstream rateid to ours...
2002 'cdr_upstream_rate' => {
2004 'upstreamratenum', 'serial', '', '', '', '',
2005 'upstream_rateid', 'varchar', '', $char_d, '', '',
2006 'ratedetailnum', 'int', 'NULL', '', '', '',
2008 'primary_key' => 'upstreamratenum', #XXX need a primary key
2009 'unique' => [ [ 'upstream_rateid' ] ], #unless we add another field, yeah
2013 'inventory_item' => {
2015 'itemnum', 'serial', '', '', '', '',
2016 'classnum', 'int', '', '', '', '',
2017 'item', 'varchar', '', $char_d, '', '',
2018 'svcnum', 'int', 'NULL', '', '', '',
2020 'primary_key' => 'itemnum',
2021 'unique' => [ [ 'classnum', 'item' ] ],
2022 'index' => [ [ 'classnum' ], [ 'svcnum' ] ],
2025 'inventory_class' => {
2027 'classnum', 'serial', '', '', '', '',
2028 'classname', 'varchar', '', $char_d, '', '',
2030 'primary_key' => 'classnum',
2037 'usernum', 'serial', '', '', '', '',
2038 'username', 'varchar', '', $char_d, '', '',
2039 '_password', 'varchar', '', $char_d, '', '',
2040 'last', 'varchar', '', $char_d, '', '',
2041 'first', 'varchar', '', $char_d, '', '',
2042 'disabled', 'char', 'NULL', 1, '', '',
2044 'primary_key' => 'usernum',
2045 'unique' => [ [ 'username' ] ],
2049 'access_user_pref' => {
2051 'prefnum', 'serial', '', '', '', '',
2052 'usernum', 'int', '', '', '', '',
2053 'prefname', 'varchar', '', $char_d, '', '',
2054 'prefvalue', 'text', 'NULL', '', '', '',
2055 'expiration', @date_type, '', '',
2057 'primary_key' => 'prefnum',
2059 'index' => [ [ 'usernum' ] ],
2064 'groupnum', 'serial', '', '', '', '',
2065 'groupname', 'varchar', '', $char_d, '', '',
2067 'primary_key' => 'groupnum',
2068 'unique' => [ [ 'groupname' ] ],
2072 'access_usergroup' => {
2074 'usergroupnum', 'serial', '', '', '', '',
2075 'usernum', 'int', '', '', '', '',
2076 'groupnum', 'int', '', '', '', '',
2078 'primary_key' => 'usergroupnum',
2079 'unique' => [ [ 'usernum', 'groupnum' ] ],
2080 'index' => [ [ 'usernum' ] ],
2083 'access_groupagent' => {
2085 'groupagentnum', 'serial', '', '', '', '',
2086 'groupnum', 'int', '', '', '', '',
2087 'agentnum', 'int', '', '', '', '',
2089 'primary_key' => 'groupagentnum',
2090 'unique' => [ [ 'groupnum', 'agentnum' ] ],
2091 'index' => [ [ 'groupnum' ] ],
2096 'rightnum', 'serial', '', '', '', '',
2097 'righttype', 'varchar', '', $char_d, '', '',
2098 'rightobjnum', 'int', '', '', '', '',
2099 'rightname', 'varchar', '', $char_d, '', '',
2101 'primary_key' => 'rightnum',
2102 'unique' => [ [ 'righttype', 'rightobjnum', 'rightname' ] ],
2108 'svcnum', 'int', '', '', '', '',
2109 'countrycode', 'varchar', '', 3, '', '',
2110 'phonenum', 'varchar', '', 15, '', '', #12 ?
2111 'pin', 'varchar', 'NULL', $char_d, '', '',
2112 'sip_password', 'varchar', 'NULL', $char_d, '', '',
2113 'phone_name', 'varchar', 'NULL', $char_d, '', '',
2115 'primary_key' => 'svcnum',
2117 'index' => [ [ 'countrycode', 'phonenum' ] ],
2122 'availnum', 'serial', '', '', '', '',
2123 'exportnum', 'int', '', '', '', '',
2124 'countrycode', 'varchar', '', 3, '', '',
2125 'state', 'char', 'NULL', 2, '', '',
2126 'npa', 'char', '', 3, '', '',
2127 'nxx', 'char', 'NULL', 3, '', '',
2128 'station', 'char', 'NULL', 4, '', '',
2129 'svcnum', 'int', 'NULL', '', '', '',
2130 'availbatch', 'varchar', 'NULL', $char_d, '', '',
2132 'primary_key' => 'availnum',
2134 'index' => [ [ 'exportnum', 'countrycode', 'state' ], #npa search
2135 [ 'exportnum', 'countrycode', 'npa' ], #nxx search
2136 [ 'exportnum', 'countrycode', 'npa', 'nxx' ],#station search
2137 [ 'exportnum', 'countrycode', 'npa', 'nxx', 'station' ], # #
2145 'typenum', 'serial', '', '', '', '',
2146 'class', 'char', '', 1, '', '',
2147 'type', 'varchar', '', $char_d, '', '',
2149 'primary_key' => 'typenum',
2156 'reasonnum', 'serial', '', '', '', '',
2157 'reason_type', 'int', '', '', '', '',
2158 'reason', 'text', '', '', '', '',
2159 'disabled', 'char', 'NULL', 1, '', '',
2161 'primary_key' => 'reasonnum',
2168 'confnum', 'serial', '', '', '', '',
2169 'agentnum', 'int', 'NULL', '', '', '',
2170 'name', 'varchar', '', $char_d, '', '',
2171 'value', 'text', 'NULL', '', '', '',
2173 'primary_key' => 'confnum',
2174 'unique' => [ [ 'agentnum', 'name' ]],
2180 'pkgrefnum', 'serial', '', '', '', '',
2181 'pkgnum', 'int', '', '', '', '',
2182 'refnum', 'int', '', '', '', '',
2184 'primary_key' => 'pkgrefnum',
2185 'unique' => [ [ 'pkgnum', 'refnum' ] ],
2186 'index' => [ [ 'pkgnum' ], [ 'refnum' ] ],
2188 # name type nullability length default local
2192 # 'num', 'serial', '', '', '', '',
2194 # 'primary_key' => 'num',