4 package OpenILS::Application::Storage::Driver::Pg::QueryParser;
5 use OpenILS::Application::Storage::QueryParser;
6 use base 'QueryParser';
7 use OpenSRF::Utils qw/:datetime/;
8 use OpenSRF::Utils::JSON;
9 use OpenILS::Application::AppUtils;
10 use OpenILS::Utils::CStoreEditor;
11 my $U = 'OpenILS::Application::AppUtils';
14 sub subquery_callback {
15 my ($invocant, $self, $struct, $filter, $params, $negate) = @_;
17 return sprintf(' ((%s)) ',
23 OpenILS::Utils::CStoreEditor
25 ->search_actor_search_query({ id => $params })
31 sub filter_group_entry_callback {
32 my ($invocant, $self, $struct, $filter, $params, $negate) = @_;
34 return sprintf(' saved_query(%s)',
40 OpenILS::Utils::CStoreEditor
42 ->search_actor_search_filter_group_entry({ id => $params })
49 my ($invocant, $self, $struct, $filter, $params, $negate) = @_;
52 my $negate_flag = ($negate ? '-' : '');
54 for my $param (@$params) {
55 my ($t,$f) = split('-', $param);
57 $treturn .= 'item_type(' . join(',',split('', $t)) . ')' if ($t);
58 $treturn .= ' ' if ($t and $f);
59 $treturn .= 'item_form(' . join(',',split('', $f)) . ')' if ($f);
60 $treturn = '(' . $treturn . ')' if ($t and $f);
61 push(@returns, $treturn) if $treturn;
63 $return = join(' || ', @returns);
64 $return = '(' . $return . ')' if(@returns > 1);
65 $return = $negate_flag.$return if($return);
73 if ($value =~ /^\d/) { # may have to use non-$ quoting
75 $value =~ s/\\/\\\\/g;
78 return "\$_$$\$$value\$_$$\$";
81 sub quote_phrase_value {
86 my $left_anchored = '';
87 my $right_anchored = '';
91 $left_anchored = $1 if $value =~ m/^([*\^])/;
92 $right_anchored = $1 if $value =~ m/([*\$])$/;
94 # We can't use word-boundary bracket expressions if the relevant char
95 # is not actually a "word" characters.
96 $left_wb = $wb if $value =~ m/^\w+/;
97 $right_wb = $wb if $value =~ m/\w+$/;
99 $value =~ s/^[*\^]// if $left_anchored;
100 $value =~ s/[*\$]$// if $right_anchored;
101 $value = quotemeta($value);
102 $value = '^' . $value if $left_anchored eq '^';
103 $value = "$value\$" if $right_anchored eq '$';
104 $value = '[[:<:]]' . $value if $left_wb && !$left_anchored;
105 $value .= '[[:>:]]' if $right_wb && !$right_anchored;
106 return $self->quote_value($value);
113 sub default_preferred_language {
117 $self->custom_data->{default_preferred_language} = $lang if ($lang);
118 return $self->custom_data->{default_preferred_language};
121 sub default_preferred_language_multiplier {
125 $self->custom_data->{default_preferred_language_multiplier} = $lang if ($lang);
126 return $self->custom_data->{default_preferred_language_multiplier};
129 sub max_popularity_importance_multiplier {
133 $self->custom_data->{max_popularity_importance_multiplier} = $max if defined($max);
134 return $self->custom_data->{max_popularity_importance_multiplier};
140 return 0 unless $self->parse_tree;
141 return 0 if @{$self->parse_tree->filters};
142 return 0 if @{$self->parse_tree->modifiers};
143 for my $node ( @{ $self->parse_tree->query_nodes } ) {
144 return 0 if (!ref($node) && $node eq '|');
145 next unless (ref($node));
146 return 0 if ($node->isa('QueryParser::query_plan'));
154 return $self->parse_tree->toSQL;
157 sub dynamic_filters {
161 $self->custom_data->{dynamic_filters} ||= [];
162 push(@{$self->custom_data->{dynamic_filters}}, $new) if ($new);
163 return $self->custom_data->{dynamic_filters};
166 sub dynamic_sorters {
170 $self->custom_data->{dynamic_sorters} ||= [];
171 push(@{$self->custom_data->{dynamic_sorters}}, $new) if ($new);
172 return $self->custom_data->{dynamic_sorters};
175 sub facet_field_id_map {
179 $self->custom_data->{facet_field_id_map} ||= {};
180 $self->custom_data->{facet_field_id_map} = $map if ($map);
181 return $self->custom_data->{facet_field_id_map};
184 sub add_facet_field_id_map {
191 $self->add_facet_field( $class => $field );
192 $self->facet_field_id_map->{by_id}{$id} = { classname => $class, field => $field, weight => $weight };
193 $self->facet_field_id_map->{by_class}{$class}{$field} = $id;
196 by_id => { $id => { classname => $class, field => $field, weight => $weight } },
197 by_class => { $class => { $field => $id } }
201 sub facet_field_class_by_id {
205 return $self->facet_field_id_map->{by_id}{$id};
208 sub facet_field_ids_by_class {
213 return undef unless ($class);
216 return [$self->facet_field_id_map->{by_class}{$class}{$field}];
219 return [values( %{ $self->facet_field_id_map->{by_class}{$class} } )];
222 sub search_field_id_map {
226 $self->custom_data->{search_field_id_map} ||= {};
227 $self->custom_data->{search_field_id_map} = $map if ($map);
228 return $self->custom_data->{search_field_id_map};
231 sub add_search_field_id_map {
237 my $combined = shift;
239 $self->add_search_field( $class => $field );
240 $self->search_field_id_map->{by_id}{$id} = { classname => $class, field => $field, weight => $weight };
241 $self->search_field_id_map->{by_class}{$class}{$field} = $id;
244 by_id => { $id => { classname => $class, field => $field, weight => $weight } },
245 by_class => { $class => { $field => $id } }
249 sub search_field_class_by_id {
253 return $self->search_field_id_map->{by_id}{$id};
256 sub search_field_ids_by_class {
261 return undef unless ($class);
264 return [$self->search_field_id_map->{by_class}{$class}{$field}];
267 return [values( %{ $self->search_field_id_map->{by_class}{$class} } )];
270 sub relevance_bumps {
274 $self->custom_data->{rel_bumps} ||= {};
275 $self->custom_data->{rel_bumps} = $bumps if ($bumps);
276 return $self->custom_data->{rel_bumps};
279 sub find_relevance_bumps {
284 return $self->relevance_bumps->{$class}{$field};
287 sub add_relevance_bump {
292 my $multiplier = shift;
295 if (defined($active) and $active eq 'f') {
301 $self->relevance_bumps->{$class}{$field}{$type} = { multiplier => $multiplier, active => $active };
303 return { $class => { $field => { $type => { multiplier => $multiplier, active => $active } } } };
306 sub search_class_weights {
309 my $a_weight = shift;
310 my $b_weight = shift;
311 my $c_weight = shift;
312 my $d_weight = shift;
314 $self->custom_data->{class_weights} ||= {};
315 # Note: This reverses the A-D order, putting D first, because that is how the call actually works in PG
316 $self->custom_data->{class_weights}->{$class} ||= [0.1, 0.2, 0.4, 1.0];
317 $self->custom_data->{class_weights}->{$class} = [$d_weight, $c_weight, $b_weight, $a_weight] if $a_weight;
318 return $self->custom_data->{class_weights}->{$class};
321 sub search_class_combined {
326 $self->custom_data->{class_combined} ||= {};
327 # Note: This reverses the A-D order, putting D first, because that is how the call actually works in PG
328 $self->custom_data->{class_combined}->{$class} ||= 0;
329 $self->custom_data->{class_combined}->{$class} = 1 if $c && $c =~ /^(?:t|y|1)/i;
330 return $self->custom_data->{class_combined}->{$class};
333 sub class_ts_config {
336 my $lang = shift || 'DEFAULT';
338 my $ts_config = shift;
340 $self->custom_data->{class_ts_config} ||= {};
341 $self->custom_data->{class_ts_config}->{$class} ||= {};
342 $self->custom_data->{class_ts_config}->{$class}->{$lang} ||= {};
343 $self->custom_data->{class_ts_config}->{$class}->{$lang}->{normal} ||= [];
344 $self->custom_data->{class_ts_config}->{$class}->{$lang}->{always} ||= [];
345 $self->custom_data->{class_ts_config}->{$class}->{'DEFAULT'} ||= {};
346 $self->custom_data->{class_ts_config}->{$class}->{'DEFAULT'}->{normal} ||= [];
347 $self->custom_data->{class_ts_config}->{$class}->{'DEFAULT'}->{always} ||= [];
350 push @{$self->custom_data->{class_ts_config}->{$class}->{$lang}->{normal}}, $ts_config unless $always;
351 push @{$self->custom_data->{class_ts_config}->{$class}->{$lang}->{always}}, $ts_config if $always;
355 push @$return, @{$self->custom_data->{class_ts_config}->{$class}->{$lang}->{always}};
356 push @$return, @{$self->custom_data->{class_ts_config}->{$class}->{$lang}->{normal}} unless $always;
357 if($lang ne 'DEFAULT') {
358 push @$return, @{$self->custom_data->{class_ts_config}->{$class}->{'DEFAULT'}->{always}};
359 push @$return, @{$self->custom_data->{class_ts_config}->{$class}->{'DEFAULT'}->{normal}} unless $always;
364 sub field_ts_config {
368 my $lang = shift || 'DEFAULT';
369 my $ts_config = shift;
371 $self->custom_data->{field_ts_config} ||= {};
372 $self->custom_data->{field_ts_config}->{$class} ||= {};
373 $self->custom_data->{field_ts_config}->{$class}->{$field} ||= {};
374 $self->custom_data->{field_ts_config}->{$class}->{$field}->{$lang} ||= [];
375 $self->custom_data->{field_ts_config}->{$class}->{$field}->{'DEFAULT'} ||= [];
378 push @{$self->custom_data->{field_ts_config}->{$class}->{$field}->{$lang}}, $ts_config;
382 push @$return, @{$self->custom_data->{field_ts_config}->{$class}->{$field}->{$lang}};
383 if($lang ne 'DEFAULT') {
384 push @$return, @{$self->custom_data->{field_ts_config}->{$class}->{$field}->{'DEFAULT'}};
386 # Make it easy on us: Grab any "always" for the class here. If we have none we grab them all.
387 push @$return, @{$self->class_ts_config($class, $lang, scalar(@$return))};
391 sub initialize_search_field_id_map {
393 my $cmf_list = shift;
395 for my $cmf (@$cmf_list) {
396 __PACKAGE__->add_search_field_id_map( $cmf->field_class, $cmf->name, $cmf->id, $cmf->weight ) if ($U->is_true($cmf->search_field));
397 __PACKAGE__->add_facet_field_id_map( $cmf->field_class, $cmf->name, $cmf->id, $cmf->weight ) if ($U->is_true($cmf->facet_field));
400 return $self->search_field_id_map;
403 sub initialize_aliases {
405 my $cmsa_list = shift;
407 for my $cmsa (@$cmsa_list) {
409 __PACKAGE__->add_search_class_alias( $cmsa->field_class, $cmsa->alias );
411 my $c = $self->search_field_class_by_id( $cmsa->field );
412 __PACKAGE__->add_search_field_alias( $cmsa->field_class, $c->{field}, $cmsa->alias );
417 sub initialize_relevance_bumps {
419 my $sra_list = shift;
421 for my $sra (@$sra_list) {
422 my $c = $self->search_field_class_by_id( $sra->field );
423 __PACKAGE__->add_relevance_bump( $c->{classname}, $c->{field}, $sra->bump_type, $sra->multiplier, $sra->active );
426 return $self->relevance_bumps;
429 sub initialize_query_normalizers {
431 my $tree = shift; # open-ils.cstore.direct.config.metabib_field_index_norm_map.search.atomic { "id" : { "!=" : null } }, { "flesh" : 1, "flesh_fields" : { "cmfinm" : ["norm"] }, "order_by" : [{ "class" : "cmfinm", "field" : "pos" }] }
433 for my $cmfinm ( @$tree ) {
434 my $field_info = $self->search_field_class_by_id( $cmfinm->field );
435 next unless $field_info;
436 __PACKAGE__->add_query_normalizer( $field_info->{classname}, $field_info->{field}, $cmfinm->norm->func, OpenSRF::Utils::JSON->JSON2perl($cmfinm->params) );
440 sub initialize_dynamic_filters {
442 my $list = shift; # open-ils.cstore.direct.config.record_attr_definition.search.atomic { "id" : { "!=" : null } }
444 for my $crad ( @$list ) {
445 __PACKAGE__->dynamic_filters( __PACKAGE__->add_search_filter( $crad->name ) ) if ($U->is_true($crad->filter));
446 __PACKAGE__->dynamic_sorters( $crad->name ) if ($U->is_true($crad->sorter));
450 sub initialize_filter_normalizers {
452 my $tree = shift; # open-ils.cstore.direct.config.record_attr_index_norm_map.search.atomic { "id" : { "!=" : null } }, { "flesh" : 1, "flesh_fields" : { "crainm" : ["norm"] }, "order_by" : [{ "class" : "crainm", "field" : "pos" }] }
454 for my $crainm ( @$tree ) {
455 __PACKAGE__->add_filter_normalizer( $crainm->attr, $crainm->norm->func, OpenSRF::Utils::JSON->JSON2perl($crainm->params) );
459 sub initialize_search_class_weights {
463 for my $search_class (@$classes) {
464 __PACKAGE__->search_class_weights( $search_class->name, $search_class->a_weight, $search_class->b_weight, $search_class->c_weight, $search_class->d_weight );
465 __PACKAGE__->search_class_combined( $search_class->name, $search_class->combined );
469 sub initialize_class_ts_config {
471 my $class_entries = shift;
473 for my $search_class_entry (@$class_entries) {
474 __PACKAGE__->class_ts_config($search_class_entry->field_class,$search_class_entry->search_lang,$U->is_true($search_class_entry->always),$search_class_entry->ts_config);
478 sub initialize_field_ts_config {
480 my $field_entries = shift;
481 my $field_objects = shift;
482 my %field_hash = map { $_->id => $_ } @$field_objects;
484 for my $search_field_entry (@$field_entries) {
485 my $field_object = $field_hash{$search_field_entry->metabib_field};
486 __PACKAGE__->field_ts_config($field_object->field_class,$field_object->name,$search_field_entry->search_lang,$search_field_entry->ts_config);
491 sub initialization_complete {
499 return $_complete if ($_complete);
501 # tsearch rank normalization adjustments. see http://www.postgresql.org/docs/9.0/interactive/textsearch-controls.html#TEXTSEARCH-RANKING for details
502 $self->custom_data->{rank_cd_weight_map} = {
503 CD_logDocumentLength => 1,
504 CD_documentLength => 2,
505 CD_meanHarmonic => 4,
507 CD_logUniqueWords => 16,
511 $self->add_search_modifier( $_ ) for (keys %{ $self->custom_data->{rank_cd_weight_map} });
513 $self->initialize_search_field_id_map( $args{config_metabib_field} )
514 if ($args{config_metabib_field});
516 $self->initialize_aliases( $args{config_metabib_search_alias} )
517 if ($args{config_metabib_search_alias});
519 $self->initialize_relevance_bumps( $args{search_relevance_adjustment} )
520 if ($args{search_relevance_adjustment});
522 $self->initialize_query_normalizers( $args{config_metabib_field_index_norm_map} )
523 if ($args{config_metabib_field_index_norm_map});
525 $self->initialize_dynamic_filters( $args{config_record_attr_definition} )
526 if ($args{config_record_attr_definition});
528 $self->initialize_filter_normalizers( $args{config_record_attr_index_norm_map} )
529 if ($args{config_record_attr_index_norm_map});
531 $self->initialize_search_class_weights( $args{config_metabib_class} )
532 if ($args{config_metabib_class});
534 $self->initialize_class_ts_config( $args{config_metabib_class_ts_map} )
535 if ($args{config_metabib_class_ts_map});
537 $self->initialize_field_ts_config( $args{config_metabib_field_ts_map}, $args{config_metabib_field} )
538 if ($args{config_metabib_field_ts_map} && $args{config_metabib_field});
541 $args{config_metabib_field_index_norm_map} &&
542 $args{search_relevance_adjustment} &&
543 $args{config_metabib_search_alias} &&
544 $args{config_metabib_field} &&
545 $args{config_record_attr_definition}
553 __PACKAGE__->allow_nested_modifiers(1);
555 __PACKAGE__->add_search_field_id_map( series => seriestitle => 1 => 1 );
557 __PACKAGE__->add_search_field_id_map( series => seriestitle => 1 => 1 );
558 __PACKAGE__->add_relevance_bump( series => seriestitle => first_word => 1.5 );
559 __PACKAGE__->add_relevance_bump( series => seriestitle => full_match => 20 );
561 __PACKAGE__->add_search_field_id_map( title => abbreviated => 2 => 1 );
562 __PACKAGE__->add_relevance_bump( title => abbreviated => first_word => 1.5 );
563 __PACKAGE__->add_relevance_bump( title => abbreviated => full_match => 20 );
565 __PACKAGE__->add_search_field_id_map( title => translated => 3 => 1 );
566 __PACKAGE__->add_relevance_bump( title => translated => first_word => 1.5 );
567 __PACKAGE__->add_relevance_bump( title => translated => full_match => 20 );
569 __PACKAGE__->add_search_field_id_map( title => proper => 6 => 1 );
570 __PACKAGE__->add_query_normalizer( title => proper => 'search_normalize' );
571 __PACKAGE__->add_relevance_bump( title => proper => first_word => 1.5 );
572 __PACKAGE__->add_relevance_bump( title => proper => full_match => 20 );
573 __PACKAGE__->add_relevance_bump( title => proper => word_order => 10 );
575 __PACKAGE__->add_search_field_id_map( author => corporate => 7 => 1 );
576 __PACKAGE__->add_relevance_bump( author => corporate => first_word => 1.5 );
577 __PACKAGE__->add_relevance_bump( author => corporate => full_match => 20 );
579 __PACKAGE__->add_facet_field_id_map( author => personal => 8 => 1 );
581 __PACKAGE__->add_search_field_id_map( author => personal => 8 => 1 );
582 __PACKAGE__->add_relevance_bump( author => personal => first_word => 1.5 );
583 __PACKAGE__->add_relevance_bump( author => personal => full_match => 20 );
584 __PACKAGE__->add_query_normalizer( author => personal => 'search_normalize' );
585 __PACKAGE__->add_query_normalizer( author => personal => 'split_date_range' );
587 __PACKAGE__->add_facet_field_id_map( subject => topic => 14 => 1 );
589 __PACKAGE__->add_search_field_id_map( subject => topic => 14 => 1 );
590 __PACKAGE__->add_relevance_bump( subject => topic => first_word => 1 );
591 __PACKAGE__->add_relevance_bump( subject => topic => full_match => 1 );
593 __PACKAGE__->add_search_field_id_map( subject => complete => 16 => 1 );
594 __PACKAGE__->add_relevance_bump( subject => complete => first_word => 1 );
595 __PACKAGE__->add_relevance_bump( subject => complete => full_match => 1 );
597 __PACKAGE__->add_search_field_id_map( keyword => keyword => 15 => 1 );
598 __PACKAGE__->add_relevance_bump( keyword => keyword => first_word => 1 );
599 __PACKAGE__->add_relevance_bump( keyword => keyword => full_match => 1 );
601 __PACKAGE__->class_ts_config( 'series', undef, 1, 'english_nostop' );
602 __PACKAGE__->class_ts_config( 'title', undef, 1, 'english_nostop' );
603 __PACKAGE__->class_ts_config( 'author', undef, 1, 'english_nostop' );
604 __PACKAGE__->class_ts_config( 'subject', undef, 1, 'english_nostop' );
605 __PACKAGE__->class_ts_config( 'keyword', undef, 1, 'english_nostop' );
606 __PACKAGE__->class_ts_config( 'series', undef, 1, 'simple' );
607 __PACKAGE__->class_ts_config( 'title', undef, 1, 'simple' );
608 __PACKAGE__->class_ts_config( 'author', undef, 1, 'simple' );
609 __PACKAGE__->class_ts_config( 'subject', undef, 1, 'simple' );
610 __PACKAGE__->class_ts_config( 'keyword', undef, 1, 'simple' );
612 # French! To test language limiters
613 __PACKAGE__->class_ts_config( 'series', 'fre', 1, 'french_nostop' );
614 __PACKAGE__->class_ts_config( 'title', 'fre', 1, 'french_nostop' );
615 __PACKAGE__->class_ts_config( 'author', 'fre', 1, 'french_nostop' );
616 __PACKAGE__->class_ts_config( 'subject', 'fre', 1, 'french_nostop' );
617 __PACKAGE__->class_ts_config( 'keyword', 'fre', 1, 'french_nostop' );
619 # Not a default config by any means, but good for some testing
620 __PACKAGE__->field_ts_config( 'author', 'personal', 'eng', 'english' );
621 __PACKAGE__->field_ts_config( 'author', 'personal', 'fre', 'french' );
623 __PACKAGE__->add_search_class_alias( keyword => 'kw' );
624 __PACKAGE__->add_search_class_alias( title => 'ti' );
625 __PACKAGE__->add_search_class_alias( author => 'au' );
626 __PACKAGE__->add_search_class_alias( author => 'name' );
627 __PACKAGE__->add_search_class_alias( author => 'dc.contributor' );
628 __PACKAGE__->add_search_class_alias( subject => 'su' );
629 __PACKAGE__->add_search_class_alias( subject => 'bib.subject(?:Title|Place|Occupation)' );
630 __PACKAGE__->add_search_class_alias( series => 'se' );
631 __PACKAGE__->add_search_class_alias( keyword => 'dc.identifier' );
633 __PACKAGE__->add_query_normalizer( author => corporate => 'search_normalize' );
634 __PACKAGE__->add_query_normalizer( keyword => keyword => 'search_normalize' );
636 __PACKAGE__->add_search_field_alias( subject => name => 'bib.subjectName' );
640 __PACKAGE__->default_search_class( 'keyword' );
642 # implements EG-specific stored subqueries
643 __PACKAGE__->add_search_filter( 'saved_query', sub { return __PACKAGE__->subquery_callback(@_) } );
644 __PACKAGE__->add_search_filter( 'filter_group_entry', sub { return __PACKAGE__->filter_group_entry_callback(@_) } );
646 # will be retained simply for back-compat
647 __PACKAGE__->add_search_filter( 'format', sub { return __PACKAGE__->format_callback(@_) } );
649 # grumble grumble, special cases against date1 and date2
650 __PACKAGE__->add_search_filter( 'before' );
651 __PACKAGE__->add_search_filter( 'after' );
652 __PACKAGE__->add_search_filter( 'between' );
653 __PACKAGE__->add_search_filter( 'during' );
655 # various filters for limiting in various ways
656 __PACKAGE__->add_search_filter( 'edit_date' );
657 __PACKAGE__->add_search_filter( 'create_date' );
658 __PACKAGE__->add_search_filter( 'statuses' );
659 __PACKAGE__->add_search_filter( 'locations' );
660 __PACKAGE__->add_search_filter( 'location_groups' );
661 __PACKAGE__->add_search_filter( 'bib_source' );
662 __PACKAGE__->add_search_filter( 'badge_orgs' );
663 __PACKAGE__->add_search_filter( 'badges' );
664 __PACKAGE__->add_search_filter( 'site' );
665 __PACKAGE__->add_search_filter( 'pref_ou' );
666 __PACKAGE__->add_search_filter( 'lasso' );
667 __PACKAGE__->add_search_filter( 'my_lasso' );
668 __PACKAGE__->add_search_filter( 'depth' );
669 __PACKAGE__->add_search_filter( 'language' );
670 __PACKAGE__->add_search_filter( 'offset' );
671 __PACKAGE__->add_search_filter( 'limit' );
672 __PACKAGE__->add_search_filter( 'check_limit' );
673 __PACKAGE__->add_search_filter( 'skip_check' );
674 __PACKAGE__->add_search_filter( 'superpage' );
675 __PACKAGE__->add_search_filter( 'superpage_size' );
676 __PACKAGE__->add_search_filter( 'estimation_strategy' );
677 __PACKAGE__->add_search_filter( 'from_metarecord' );
678 __PACKAGE__->add_search_modifier( 'available' );
679 __PACKAGE__->add_search_modifier( 'staff' );
680 __PACKAGE__->add_search_modifier( 'deleted' );
681 __PACKAGE__->add_search_modifier( 'lucky' );
683 # Start from container data (bre, acn, acp): container(bre,bookbag,123,deadb33fdeadb33fdeadb33fdeadb33f)
684 __PACKAGE__->add_search_filter( 'container' );
686 # Start from a list of record ids, either bre or metarecords, depending on the #metabib modifier
687 __PACKAGE__->add_search_filter( 'record_list' );
689 __PACKAGE__->add_search_filter( 'has_browse_entry' );
691 # used internally, but generally not user-settable
692 __PACKAGE__->add_search_filter( 'preferred_language' );
693 __PACKAGE__->add_search_filter( 'preferred_language_weight' );
694 __PACKAGE__->add_search_filter( 'preferred_language_multiplier' );
695 __PACKAGE__->add_search_filter( 'core_limit' );
697 # XXX Valid values to be supplied by SVF
698 __PACKAGE__->add_search_filter( 'sort' );
700 # modifies core query, not configurable
701 __PACKAGE__->add_search_modifier( 'descending' );
702 __PACKAGE__->add_search_modifier( 'ascending' );
703 __PACKAGE__->add_search_modifier( 'nullsfirst' );
704 __PACKAGE__->add_search_modifier( 'nullslast' );
705 __PACKAGE__->add_search_modifier( 'metarecord' );
706 __PACKAGE__->add_search_modifier( 'metabib' );
709 #-------------------------------
710 package OpenILS::Application::Storage::Driver::Pg::QueryParser::query_plan;
711 use base 'QueryParser::query_plan';
712 use OpenSRF::Utils::Logger qw($logger);
713 use OpenSRF::Utils qw/:datetime/;
715 use OpenILS::Application::AppUtils;
716 my $apputils = "OpenILS::Application::AppUtils";
718 our %_dfilter_controlled_cache = ();
719 our %_dfilter_stats_cache = ();
720 our $_pg_version = 0;
722 sub dynamic_filter_compile {
723 my ($self, $filter, $params, $negate) = @_;
724 my $e = OpenILS::Utils::CStoreEditor->new;
726 $negate = $negate ? '!' : '';
729 ($_pg_version = $e->json_query({from => ['version']})->[0]->{version}) =~ s/^.+?(\d\.\d).+$/$1/;
733 if ($_pg_version >= 9.2) {
734 if (!scalar keys %_dfilter_stats_cache) {
735 my $data = $e->json_query({from => ['evergreen.pg_statistics', 'record_attr_vector_list', 'vlist']});
736 %_dfilter_stats_cache = map {
737 ( $_->{element}, $_->{frequency} )
738 } grep { $_->{frequency} > 5 } @$data; # Pin floor to 5% of the table
741 $common = 1; # Assume it's expensive
744 if (!exists($_dfilter_controlled_cache{$filter})) {
745 my $crad = $e->retrieve_config_record_attr_definition($filter);
746 my $ccvm_list = $e->search_config_coded_value_map({ctype =>$filter});
748 $_dfilter_controlled_cache{$filter} = $crad->to_bare_hash;
749 $_dfilter_controlled_cache{$filter}{controlled} = scalar @$ccvm_list;
752 my $method = $_dfilter_controlled_cache{$filter}{controlled} ?
753 'search_config_coded_value_map' : 'search_metabib_uncontrolled_record_attr_value';
754 my $attr_field = $_dfilter_controlled_cache{$filter}{controlled} ?
756 my $value_field = $_dfilter_controlled_cache{$filter}{controlled} ?
759 my $attr_objects = $e->$method({ $attr_field => $filter, $value_field => $params });
760 $common = scalar(grep { exists($_dfilter_stats_cache{$_->id}) } @$attr_objects) unless $common;
762 return (sprintf('%s(%s)', $negate,
765 map { $_->id } @$attr_objects
775 for my $f ( qw/preferred_language preferred_language_multiplier preferred_language_weight core_limit check_limit skip_check superpage superpage_size/ ) {
777 $col = 'preferred_language_multiplier' if ($f eq 'preferred_language_weight');
778 my ($filter) = $self->find_filter($f);
779 if ($filter and @{$filter->args}) {
780 $filters{$col} = $filter->args->[0];
784 $self->QueryParser->superpage($filters{superpage}) if ($filters{superpage});
785 $self->QueryParser->superpage_size($filters{superpage_size}) if ($filters{superpage_size});
786 $self->QueryParser->core_limit($filters{core_limit}) if ($filters{core_limit});
788 $logger->debug("Query plan:\n".Dumper($self));
790 my $flat_plan = $self->flatten;
792 # generate the relevance ranking
793 my $rel = '1'; # Default to something simple in case rank_list is empty.
794 if (@{$$flat_plan{rank_list}}) {
797 . join(")\n" . ${spc} x 5 . "+ (", @{$$flat_plan{rank_list}})
799 . ${spc} x 4 . ")+1";
802 # find any supplied sort option
803 my ($sort_filter) = $self->find_filter('sort');
805 $sort_filter = $sort_filter->args->[0];
807 $sort_filter = 'rel';
811 if (($filters{preferred_language} || $self->QueryParser->default_preferred_language) && ($filters{preferred_language_multiplier} || $self->QueryParser->default_preferred_language_multiplier)) {
813 my $pl = $self->QueryParser->quote_value( $filters{preferred_language} ? $filters{preferred_language} : $self->QueryParser->default_preferred_language );
814 $$flat_plan{with} .= ',' if $$flat_plan{with};
815 $$flat_plan{with} .= "lang_with AS (SELECT id FROM config.coded_value_map WHERE ctype = 'item_lang' AND code = $pl)";
816 $lang_join = ",lang_with";
818 my $plw = $filters{preferred_language_multiplier} ? $filters{preferred_language_multiplier} : $self->QueryParser->default_preferred_language_multiplier;
819 $rel = "($rel * COALESCE( NULLIF( FIRST(mrv.vlist \@> ARRAY[lang_with.id]), FALSE )::INT * $plw, 1))";
820 $$flat_plan{uses_mrv} = 1;
824 if ($$flat_plan{uses_mrv}) {
825 $mrv_join = 'INNER JOIN metabib.record_attr_vector_list mrv ON m.source = mrv.source';
829 if ($$flat_plan{uses_mrd}) {
830 $mra_join = 'INNER JOIN metabib.record_attr mrd ON m.source = mrd.id';
833 my $pubdate_join = "LEFT JOIN metabib.record_sorter pubdate_t ON m.source = pubdate_t.source AND attr = 'pubdate'";
836 if ($self->find_modifier('deleted')) {
837 $bre_join = 'INNER JOIN biblio.record_entry bre ON m.source = bre.id AND bre.deleted';
838 # The above suffices for filters too when the #deleted modifier
840 } elsif ($$flat_plan{uses_bre}) {
841 $bre_join = 'INNER JOIN biblio.record_entry bre ON m.source = bre.id';
845 $desc = 'DESC' if ($self->find_modifier('descending'));
847 my $nullpos = 'NULLS LAST';
848 $nullpos = 'NULLS FIRST' if ($self->find_modifier('nullsfirst'));
850 # Do we have a badges() filter?
852 my ($badge_filter) = $self->find_filter('badges');
853 if ($badge_filter && @{$badge_filter->args}) {
854 $badges = join (',', grep /^\d+$/, @{$badge_filter->args});
857 # Do we have a badge_orgs() filter? (used for calculating popularity)
859 my ($bo_filter) = $self->find_filter('badge_orgs');
860 if ($bo_filter && @{$bo_filter->args}) {
861 $borgs = join (',', grep /^\d+$/, @{$bo_filter->args});
864 # Build the badge-ish WITH query
865 my $pop_with = <<' WITH';
868 ARRAY_AGG(badge) AS badges,
869 SUM(s.score::NUMERIC*b.weight::NUMERIC)/SUM(b.weight::NUMERIC) AS total_score
870 FROM rating.record_badge_score s
871 JOIN rating.badge b ON (
875 $pop_with .= " AND b.id = ANY ('{$badges}')" if ($badges);
876 $pop_with .= " AND b.scope = ANY ('{$borgs}')" if ($borgs);
877 $pop_with .= ') GROUP BY 1)';
879 my $pop_join = $badges ? # inner join if we are restricting via badges()
880 'INNER JOIN pop_with ON ( m.source = pop_with.record )' :
881 'LEFT JOIN pop_with ON ( m.source = pop_with.record )';
883 $$flat_plan{with} .= ',' if $$flat_plan{with};
884 $$flat_plan{with} .= $pop_with;
888 my $pop_extra_sort = '';
889 if (grep {$_ eq $sort_filter} @{$self->QueryParser->dynamic_sorters}) {
890 $rank = "FIRST((SELECT value FROM metabib.record_sorter rbr WHERE rbr.source = m.source and attr = '$sort_filter'))"
891 } elsif ($sort_filter eq 'create_date') {
892 $rank = "FIRST((SELECT create_date FROM biblio.record_entry rbr WHERE rbr.id = m.source))";
893 } elsif ($sort_filter eq 'edit_date') {
894 $rank = "FIRST((SELECT edit_date FROM biblio.record_entry rbr WHERE rbr.id = m.source))";
895 } elsif ($sort_filter eq 'poprel') {
896 my $max_mult = $self->QueryParser->max_popularity_importance_multiplier() // 2.0;
897 $max_mult = 0.1 if $max_mult < 0.1; # keep it within reasonable bounds,
898 # and avoid the division-by-zero error
899 # you'd get if you allowed it to be
902 if ( $max_mult == 1.0 ) { # no adjustment requested by the configuration
903 $rank = "1.0/($rel)::NUMERIC";
904 } else { # calculate adjustment
906 # Scale the 0-5 effect of popularity badges by providing a multiplier
907 # for the badge average based on the overall maximum
908 # multiplier. Two examples, comparing the effect to the default
909 # $max_mult value of 2.0, which causes a $adjusted_scale value
912 # * Given the default $max_mult of 2.0, the value of
913 # $adjusted_scale will be 0.2 [($max_mult - 1.0) / 5.0].
914 # For a record whose average badge score is the maximum
915 # of 5.0, that would make the relevance multiplier be
917 # 1.0 + (5.0 [average score] * 0.2 [ $adjusted_scale ],
918 # This would have the effect of doubling the effective
919 # relevance of highly popular items.
921 # * Given a $max_mult of 1.1, the value of $adjusted_scale
922 # will be 0.02, meaning that the average badge value will be
923 # multiplied by 0.02 rather than 0.2, then added to 1.0 and
924 # used as a multiplier against the base relevance. Thus a
925 # change of at most 10% to the base relevance for a record
926 # with a 5.0 average badge score. This will allow records
927 # that are naturally very relevant to avoid being pushed
928 # below badge-heavy records.
930 # * Given a $max_mult of 3.0, the value of $adjusted_scale
931 # will be 0.4, meaning that the average badge value will be
932 # multiplied by 0.4 rather than 0.2, then added to 1.0 and
933 # used as a multiplier against the base relevance. Thus a
934 # change of as much as 200% to (or three times the size of)
935 # the base relevance for a record with a 5.0 average badge
936 # score. This in turn will cause badges to outweigh
937 # relevance to a very large degree.
939 # The maximum badge multiplier can be set to a value less than
940 # 1.0; this would have the effect of making less popular items
941 # show up higher in the results. While this is not a likely
942 # option for production use, it could be useful for identifying
943 # interesting long-tail hits, particularly in a database
944 # where enough badges are configured so that very few records
945 # have an overage badge score of zero.
947 my $adjusted_scale = ( $max_mult - 1.0 ) / 5.0;
948 $rank = "1.0/(( $rel ) * (1.0 + (AVG(COALESCE(pop_with.total_score::NUMERIC,0.0::NUMERIC)) * ${adjusted_scale}::NUMERIC)))::NUMERIC";
950 } elsif ($sort_filter =~ /^pop/) {
951 $rank = '1.0/(AVG(COALESCE(pop_with.total_score::NUMERIC,0.0::NUMERIC)) + 5.0::NUMERIC)::NUMERIC';
952 my $pop_desc = $desc eq 'ASC' ? 'DESC' : 'ASC';
953 $pop_extra_sort = "3 $pop_desc $nullpos,";
955 # default to rel ranking
956 $rank = "1.0/($rel)::NUMERIC";
959 my $key = 'm.source';
960 $key = 'm.metarecord' if (grep {$_->name eq 'metarecord' or $_->name eq 'metabib'} @{$self->modifiers});
962 my $core_limit = $self->QueryParser->core_limit || 25000;
963 $core_limit = 1 if($self->find_modifier('lucky'));
965 my $flat_where = $$flat_plan{where};
966 if ($flat_where ne '') {
967 $flat_where = "AND (\n" . ${spc} x 5 . $flat_where . "\n" . ${spc} x 4 . ")";
969 my $with = $$flat_plan{with};
970 $with= "\nWITH $with" if $with;
972 # Need an array for query parser db function; this gives a better plan
973 # than the ARRAY_AGG(DISTINCT m.source) option as of PostgreSQL 9.1
974 my $agg_records = 'ARRAY[m.source] AS records';
975 if ($key =~ /metarecord/) {
976 # metarecord searches still require the ARRAY_AGG approach
977 $agg_records = 'ARRAY_AGG(DISTINCT m.source) AS records';
984 (${rel})::NUMERIC AS rel,
986 FIRST(pubdate_t.value) AS tie_break,
987 STRING_AGG(ARRAY_TO_STRING(pop_with.badges,','),',') AS badges,
988 AVG(COALESCE(pop_with.total_score::NUMERIC,0.0::NUMERIC))::NUMERIC(2,1) AS popularity
989 FROM metabib.metarecord_source_map m
1000 ORDER BY 4 $desc $nullpos, $pop_extra_sort 5 DESC $nullpos, 3 DESC
1004 warn $sql if $self->QueryParser->debug;
1012 die 'ERROR: nesting too deep or boolean list too long' if ($self->plan_level > 40);
1014 my $from = shift || '';
1015 my $where = shift || '';
1022 for my $node ( @{$self->query_nodes} ) {
1025 if ($node->isa( 'QueryParser::query_plan::node' )) {
1027 unless (@{$node->only_atoms}) {
1028 push @rank_list, '1';
1033 my $table = $node->table;
1034 my $ctable = $node->combined_table;
1035 my $talias = $node->table_alias;
1037 my $node_rank = 'COALESCE(' . $node->rank . " * ${talias}.weight, 0.0)";
1039 $from .= "\n" . ${spc} x 4 ."LEFT JOIN (\n"
1040 . ${spc} x 5 . "SELECT fe.*, fe_weight.weight, ${talias}_xq.tsq, ${talias}_xq.tsq_rank /* search */\n"
1041 . ${spc} x 6 . "FROM $table AS fe";
1042 $from .= "\n" . ${spc} x 7 . "JOIN config.metabib_field AS fe_weight ON (fe_weight.id = fe.field)";
1046 if (@{$node->fields} > 0) {
1047 @bump_fields = @{$node->fields};
1049 @field_ids = grep defined, (
1051 $self->QueryParser->search_field_ids_by_class(
1052 $node->classname, $_
1057 @bump_fields = @{$self->QueryParser->search_fields->{$node->classname}};
1060 if ($node->dummy_count < @{$node->only_atoms} ) {
1061 $with .= ",\n " if $with;
1062 $with .= "${talias}_xq AS (SELECT ". $node->tsquery ." AS tsq,". $node->tsquery_rank ." AS tsq_rank )";
1063 if ($node->combined_search) {
1064 $from .= "\n" . ${spc} x 6 . "JOIN $ctable AS com ON (com.record = fe.source";
1066 $from .= " AND com.metabib_field IN (" . join(',',@field_ids) . "))";
1068 $from .= " AND com.metabib_field IS NULL)";
1070 $from .= "\n" . ${spc} x 6 . "JOIN ${talias}_xq ON (com.index_vector @@ ${talias}_xq.tsq)";
1072 $from .= "\n" . ${spc} x 6 . "JOIN ${talias}_xq ON (fe.index_vector @@ ${talias}_xq.tsq)";
1075 $from .= "\n" . ${spc} x 6 . ", (SELECT NULL::tsquery AS tsq, NULL:tsquery AS tsq_rank ) AS ${talias}_xq";
1079 $from .= "\n" . ${spc} x 6 . "WHERE fe_weight.id IN (" .
1080 join(',', @field_ids) . ")";
1083 $from .= "\n" . ${spc} x 4 . ") AS $talias ON (m.source = ${talias}.source)";
1088 for my $field ( @bump_fields ) {
1089 my $bumps = $self->QueryParser->find_relevance_bumps( $node->classname => $field );
1090 for my $b (keys %$bumps) {
1091 next if (!$$bumps{$b}{active});
1092 next if ($used_bumps{$b});
1093 $used_bumps{$b} = 1;
1095 next if ($$bumps{$b}{multiplier} == 1); # optimization to remove unneeded bumps
1097 push @bumpmults, $$bumps{$b}{multiplier};
1101 if(scalar @bumps > 0 && scalar @{$node->only_positive_atoms} > 0) {
1102 # Note: Previous rank function used search_normalize outright. Duplicating that here.
1103 $node_rank .= "\n" . ${spc} x 5 . "* evergreen.rel_bump(('{' || quote_literal(search_normalize(";
1104 $node_rank .= join(")) || ',' || quote_literal(search_normalize(",map { $self->QueryParser->quote_phrase_value($_->content) } @{$node->only_positive_atoms});
1105 $node_rank .= ")) || '}')::TEXT[], " . $node->table_alias . ".value, '{" . join(",",@bumps) . "}'::TEXT[], '{" . join(",",@bumpmults) . "}'::NUMERIC[])";
1109 $NOT = 'NOT ' if $node->negate;
1111 $where .= "$NOT(" . $talias . ".id IS NOT NULL";
1112 if (@{$node->phrases}) {
1113 $where .= ' AND ' . join(' AND ', map {
1114 "${talias}.value ~* ".$self->QueryParser->quote_phrase_value($_, 1)
1115 } @{$node->phrases});
1117 for my $atom (@{$node->only_real_atoms}) {
1118 next unless $atom->{content} && $atom->{content} =~ /(^\^|\$$)/;
1119 $where .= " AND ${talias}.value ~* ".$self->QueryParser->quote_phrase_value($atom->{content});
1124 push @rank_list, $node_rank;
1126 } elsif ($node->isa( 'QueryParser::query_plan::facet' )) {
1128 my $talias = $node->table_alias;
1131 if (@{$node->fields} > 0) {
1132 push(@field_ids, $self->QueryParser->facet_field_ids_by_class( $node->classname, $_ )->[0]) for (@{$node->fields});
1134 @field_ids = @{ $self->QueryParser->facet_field_ids_by_class( $node->classname ) };
1137 my $join_type = ($node->negate or !$self->top_plan) ? 'LEFT' : 'INNER';
1138 $from .= "\n${spc}$join_type JOIN /* facet */ metabib.facet_entry $talias ON (\n"
1139 . ${spc} x 2 . "m.source = ${talias}.source\n"
1140 . ${spc} x 2 . "AND SUBSTRING(${talias}.value,1,1024) IN ("
1141 . join(",", map { $self->QueryParser->quote_value($_) } @{$node->values}) . ")\n"
1142 . ${spc} x 2 ."AND ${talias}.field IN (". join(',', @field_ids) . ")\n"
1145 if ($join_type ne 'INNER') {
1146 my $NOT = $node->negate ? '' : ' NOT';
1147 $where .= "${talias}.id IS$NOT NULL";
1148 } elsif ($where ne '') {
1149 # Strip extra joiner
1150 $where =~ s/(\s|\n)+(AND|OR)\s$//;
1154 my $subnode = $node->flatten;
1156 # strip the trailing bool from the previous loop if there is
1157 # nothing to add to the where within this loop.
1158 if ($$subnode{where} eq '') {
1159 $where =~ s/(\s|\n)+(AND|OR)\s$//;
1162 push(@rank_list, @{$$subnode{rank_list}});
1163 $from .= $$subnode{from};
1166 $NOT = 'NOT ' if $node->negate;
1168 if ($$subnode{where} ne '') {
1170 . ${spc} x ($self->plan_level + 6) . $$subnode{where} . "\n"
1171 . ${spc} x ($self->plan_level + 5) . ')';
1174 if ($$subnode{with}) {
1175 $with .= ",\n " if $with;
1176 $with .= $$subnode{with};
1179 $uses_bre = $$subnode{uses_bre};
1180 $uses_mrd = $$subnode{uses_mrd};
1181 $uses_mrv = $$subnode{uses_mrv};
1185 warn "flatten(): appending WHERE bool to: $where\n" if $self->QueryParser->debug;
1188 $where .= "\n" . ${spc} x ( $self->plan_level + 5 ) . 'AND ' if ($node eq '&');
1189 $where .= "\n" . ${spc} x ( $self->plan_level + 5 ) . 'OR ' if ($node eq '|');
1194 my $joiner = "\n" . ${spc} x ( $self->plan_level + 5 ) . ($self->joiner eq '&' ? 'AND ' : 'OR ');
1198 # for each dynamic filter, build more of the WHERE clause
1199 for my $filter (@{$self->filters}) {
1200 my $NOT = $filter->negate ? 'NOT ' : '';
1201 if (grep { $_ eq $filter->name } @{ $self->QueryParser->dynamic_filters }) {
1203 my $fname = $filter->name;
1204 $fname = 'item_lang' if $fname eq 'language'; #XXX filter aliases
1206 warn "flatten(): processing dynamic filter ". $filter->name ."\n"
1207 if $self->QueryParser->debug;
1210 ($vlist_query, $common) = $self->dynamic_filter_compile( $fname, $filter->args, $filter->negate );
1212 # bool joiner for intra-plan nodes/filters
1213 push(@dlist, $self->joiner) if @dlist;
1214 push(@dlist, $vlist_query);
1217 if ($filter->name eq 'before') {
1218 if (@{$filter->args} == 1) {
1219 $where .= $joiner if $where ne '';
1220 $where .= "${NOT}COALESCE(pubdate_t.value <= "
1221 . $self->QueryParser->quote_value($filter->args->[0])
1224 } elsif ($filter->name eq 'after') {
1225 if (@{$filter->args} == 1) {
1226 $where .= $joiner if $where ne '';
1227 $where .= "${NOT}COALESCE(pubdate_t.value >= "
1228 . $self->QueryParser->quote_value($filter->args->[0])
1231 } elsif ($filter->name eq 'during') {
1232 if (@{$filter->args} == 1) {
1233 $where .= $joiner if $where ne '';
1234 $where .= "${NOT}COALESCE("
1235 . $self->QueryParser->quote_value($filter->args->[0])
1236 . " BETWEEN pubdate_t.value AND (mrd.attrs->'date2'), false)";
1239 } elsif ($filter->name eq 'between') {
1240 if (@{$filter->args} == 2) {
1241 $where .= $joiner if $where ne '';
1242 $where .= "${NOT}COALESCE(pubdate_t.value BETWEEN "
1243 . $self->QueryParser->quote_value($filter->args->[0])
1245 . $self->QueryParser->quote_value($filter->args->[1])
1248 } elsif ($filter->name eq 'container') {
1249 if (@{$filter->args} >= 3) {
1250 my ($class, $ctype, $cid, $token) = @{$filter->args};
1253 my $rec_field = 'ci.target_biblio_record_entry';
1254 if ($class eq 'bre') {
1255 $class = 'biblio_record_entry';
1256 } elsif ($class eq 'acn') {
1257 $class = 'call_number';
1258 $rec_field = 'cn.record';
1259 $rec_join = 'JOIN asset.call_number cn ON (ci.target_call_number = cn.id)';
1260 } elsif ($class eq 'acp') {
1262 $rec_field = 'cn.record';
1263 $rec_join = 'JOIN asset.copy cp ON (ci.target_copy = cp.id) JOIN asset.call_number cn ON (cp.call_number = cn.id)';
1269 my ($u,$e) = $apputils->checksesperm($token) if ($token);
1270 $perm_join = ' OR c.owner = ' . $u->id if ($u && !$e);
1272 my $filter_alias = "$filter";
1273 $filter_alias =~ s/^.*\(0(x[0-9a-fA-F]+)\)$/$1/go;
1274 $filter_alias =~ s/\|/_/go;
1276 $with .= ",\n " if $with;
1277 $with .= "container_${filter_alias} AS (\n";
1278 $with .= " SELECT $rec_field AS record FROM container.${class}_bucket_item ci\n"
1279 . " JOIN container.${class}_bucket c ON (c.id = ci.bucket) $rec_join\n"
1280 . " WHERE c.btype = " . $self->QueryParser->quote_value($ctype) . "\n"
1281 . " AND c.id = " . $self->QueryParser->quote_value($cid) . "\n"
1282 . " AND (c.pub IS TRUE$perm_join)\n";
1283 if ($class eq 'copy') {
1285 . " SELECT pr.peer_record AS record FROM container.copy_bucket_item ci\n"
1286 . " JOIN container.copy_bucket c ON (c.id = ci.bucket)\n"
1287 . " JOIN biblio.peer_bib_copy_map pr ON ci.target_copy = pr.target_copy\n"
1288 . " WHERE c.btype = " . $self->QueryParser->quote_value($ctype) . "\n"
1289 . " AND c.id = " . $self->QueryParser->quote_value($cid) . "\n"
1290 . " AND (c.pub IS TRUE$perm_join)\n";
1294 my $optimize_join = 1 if $self->top_plan and !$NOT;
1295 $from .= "\n" . ${spc} x 3 . ( $optimize_join ? 'INNER' : 'LEFT') . " JOIN container_${filter_alias} ON container_${filter_alias}.record = m.source";
1297 if (!$optimize_join) {
1298 $where .= $joiner if $where ne '';
1299 $where .= "(container_${filter_alias} IS " . ( $NOT ? 'NULL)' : 'NOT NULL)');
1303 } elsif ($filter->name eq 'record_list') {
1304 if (@{$filter->args} > 0) {
1305 my $key = 'm.source';
1306 $key = 'm.metarecord' if (grep {$_->name eq 'metarecord' or $_->name eq 'metabib'} @{$self->QueryParser->parse_tree->modifiers});
1307 $where .= $joiner if $where ne '';
1308 $where .= "$key ${NOT}IN (" . join(',', map { $self->QueryParser->quote_value($_) } @{$filter->args}) . ')';
1311 } elsif ($filter->name eq 'has_browse_entry') {
1312 if (@{$filter->args} >= 2) {
1313 my $entry = int(shift @{$filter->args});
1314 my $fields = join(",", map(int, @{$filter->args}));
1315 $from .= "\n" . $spc x 3 . sprintf("INNER JOIN metabib.browse_entry_def_map mbedm ON (mbedm.source = m.source AND mbedm.entry = %d AND mbedm.def IN (%s))", $entry, $fields);
1317 } elsif ($filter->name eq 'edit_date' or $filter->name eq 'create_date') {
1318 # bre.create_date and bre.edit_date filtering
1319 my $datefilter = $filter->name;
1323 if ($filter && $filter->args && scalar(@{$filter->args}) > 0 && scalar(@{$filter->args}) < 3) {
1324 my ($cstart, $cend) = @{$filter->args};
1326 if (!$cstart and !$cend) {
1327 # useless use of filter
1328 } elsif (!$cstart or $cstart eq '-infinity') { # no start supplied
1329 if ($cend eq 'infinity') {
1330 # useless use of filter
1333 $cend = cleanse_ISO8601($cend);
1334 $where .= $joiner if $where ne '';
1335 $where .= "bre.$datefilter <= \$_$$\$$cend\$_$$\$";
1338 } elsif (!$cend or $cend eq 'infinity') { # no end supplied
1339 if ($cstart eq '-infinity') {
1340 # useless use of filter
1341 } else { # "after $cstart"
1342 $cstart = cleanse_ISO8601($cstart);
1343 $where .= $joiner if $where ne '';
1344 $where .= "bre.$datefilter >= \$_$$\$$cstart\$_$$\$";
1346 } else { # both supplied
1347 # "between $cstart and $cend"
1348 $cstart = cleanse_ISO8601($cstart);
1349 $cend = cleanse_ISO8601($cend);
1350 $where .= $joiner if $where ne '';
1351 $where .= "bre.$datefilter BETWEEN \$_$$\$$cstart\$_$$\$ AND \$_$$\$$cend\$_$$\$";
1354 } elsif ($filter->name eq 'bib_source') {
1357 if (@{$filter->args} > 0) {
1358 $where .= $joiner if $where ne '';
1359 $where .= "${NOT}COALESCE(bre.source IN ("
1360 . join(',', map { $self->QueryParser->quote_value($_) } @{ $filter->args })
1363 } elsif ($filter->name eq 'from_metarecord') {
1364 if (@{$filter->args} > 0) {
1365 my $key = 'm.metarecord';
1366 $where .= $joiner if $where ne '';
1367 $where .= "$key ${NOT}IN (" . join(',', map { $self->QueryParser->quote_value($_) } @{$filter->args}) . ')';
1375 $where .= $joiner if $where ne '';
1376 if ($common) { # Use a function wrapper to inform PG of the non-rareness of one or more filter elements
1378 'evergreen.query_int_wrapper(mrv.vlist, \'%s\')',
1383 'mrv.vlist @@ \'%s\'',
1389 warn "flatten(): full filter where => $where\n" if $self->QueryParser->debug;
1392 rank_list => \@rank_list,
1396 uses_bre => $uses_bre,
1397 uses_mrv => $uses_mrv,
1398 uses_mrd => $uses_mrd
1403 #-------------------------------
1404 package OpenILS::Application::Storage::Driver::Pg::QueryParser::query_plan::filter;
1405 use base 'QueryParser::query_plan::filter';
1407 #-------------------------------
1408 package OpenILS::Application::Storage::Driver::Pg::QueryParser::query_plan::facet;
1409 use base 'QueryParser::query_plan::facet';
1413 my ($classname) = split '\|', $self->name;
1419 my ($classname,@fields) = split '\|', $self->name;
1426 my $table_alias = "$self";
1427 $table_alias =~ s/^.*\(0(x[0-9a-fA-F]+)\)$/$1/go;
1428 $table_alias .= '_' . $self->name;
1429 $table_alias =~ s/\|/_/go;
1431 return $table_alias;
1435 #-------------------------------
1436 package OpenILS::Application::Storage::Driver::Pg::QueryParser::query_plan::modifier;
1437 use base 'QueryParser::query_plan::modifier';
1439 #-------------------------------
1440 package OpenILS::Application::Storage::Driver::Pg::QueryParser::query_plan::node::atom;
1441 use base 'QueryParser::query_plan::node::atom';
1447 $self->{sql} = $sql if ($sql);
1449 return $self->{sql} if ($self->{sql});
1450 return $self->buildSQL;
1456 my $classname = $self->node->classname;
1458 return $self->sql("to_tsquery('$classname','')") if $self->{dummy};
1460 my $normalizers = $self->node->plan->QueryParser->query_normalizers( $classname );
1461 my $fields = $self->node->fields;
1464 my $filter = $self->node->plan->find_filter('preferred_language');
1465 $lang ||= $filter->args->[0] if ($filter && $filter->args);
1466 $lang ||= $self->node->plan->QueryParser->default_preferred_language;
1467 my $ts_configs = [];
1469 if (@{$self->node->phrases}) {
1470 # We assume we want 'simple' for phrases. Gives us less to match against later.
1471 $ts_configs = ['simple'];
1474 $ts_configs = $self->node->plan->QueryParser->class_ts_config($classname, $lang);
1476 for my $field (@$fields) {
1477 push @$ts_configs, @{$self->node->plan->QueryParser->field_ts_config($classname, $field, $lang)};
1480 $ts_configs = [keys %{{map { $_ => 1 } @$ts_configs}}];
1483 # Assume we want exact if none otherwise provided.
1484 # Because we can reasonably expect this to exist
1485 $ts_configs = ['simple'] unless (scalar @$ts_configs);
1487 $fields = $self->node->plan->QueryParser->search_fields->{$classname} if (!@$fields);
1491 for my $field (@$fields) {
1492 for my $nfield (keys %$normalizers) {
1493 for my $nizer ( @{$$normalizers{$nfield}} ) {
1494 if ($field eq $nfield) {
1495 my $param_string = OpenSRF::Utils::JSON->perl2JSON($nizer->{params});
1496 if (!exists($norms{$nizer->{function}.$param_string})) {
1497 $norms{$nizer->{function}.$param_string} = {p=>$pos++,n=>$nizer};
1504 my $sql = $self->node->plan->QueryParser->quote_value($self->content);
1506 for my $n ( map { $$_{n} } sort { $$a{p} <=> $$b{p} } values %norms ) {
1507 $sql = join(', ', $sql, map { $self->node->plan->QueryParser->quote_value($_) } @{ $n->{params} });
1508 $sql = $n->{function}."($sql)";
1511 my $prefix = $self->prefix || '';
1512 my $suffix = $self->suffix || '';
1513 my $joiner = ' || ';
1514 $joiner = ' && ' if $self->prefix eq '!'; # Negative atoms should be "none of the variants" instead of "any of the variants"
1516 $prefix = "'$prefix' ||" if $prefix;
1518 my $suffix_after = '';
1520 $suffix_op = ":$suffix" if $suffix;
1521 $suffix_after = "|| '$suffix_op'" if $suffix;
1524 for my $ts_config (@$ts_configs) {
1525 push @sql_set, "to_tsquery('$ts_config', COALESCE(NULLIF($prefix '(' || btrim(regexp_replace($sql,E'(?:\\\\s+|:)','$suffix_op&','g'),'&|') $suffix_after || ')', '()'), ''))";
1528 $sql = join($joiner, @sql_set);
1529 $sql = '(' . $sql . ')' if (scalar(@$ts_configs) > 1);
1531 return $self->sql($sql);
1534 #-------------------------------
1535 package OpenILS::Application::Storage::Driver::Pg::QueryParser::query_plan::node;
1536 use base 'QueryParser::query_plan::node';
1541 $self->{dummy_count} = 0;
1543 my $atoms = $self->query_atoms;
1545 for my $a (@$atoms) {
1546 push(@only_atoms, $a) if (ref($a) && $a->isa('QueryParser::query_plan::node::atom'));
1547 $self->{dummy_count}++ if (ref($a) && $a->{dummy});
1550 return \@only_atoms;
1553 sub only_real_atoms {
1556 my $atoms = $self->query_atoms;
1557 my @only_real_atoms;
1558 for my $a (@$atoms) {
1559 push(@only_real_atoms, $a) if (ref($a) && $a->isa('QueryParser::query_plan::node::atom') && !($a->{dummy}));
1562 return \@only_real_atoms;
1565 sub only_positive_atoms {
1568 my $atoms = $self->query_atoms;
1569 my @only_positive_atoms;
1570 for my $a (@$atoms) {
1571 push(@only_positive_atoms, $a) if (ref($a) && $a->isa('QueryParser::query_plan::node::atom') && !($a->{dummy}) && ($a->{prefix} ne '!'));
1574 return \@only_positive_atoms;
1579 return $self->{dummy_count};
1585 $self->{table} = $table if ($table);
1586 return $self->{table} if $self->{table};
1587 return $self->table( 'metabib.' . $self->classname . '_field_entry' );
1590 sub combined_table {
1593 $self->{ctable} = $ctable if ($ctable);
1594 return $self->{ctable} if $self->{ctable};
1595 return $self->combined_table( 'metabib.combined_' . $self->classname . '_field_entry' );
1598 sub combined_search {
1600 return $self->plan->QueryParser->search_class_combined($self->classname);
1605 my $table_alias = shift;
1606 $self->{table_alias} = $table_alias if ($table_alias);
1607 return $self->{table_alias} if ($self->{table_alias});
1609 $table_alias = "$self";
1610 $table_alias =~ s/^.*\(0(x[0-9a-fA-F]+)\)$/$1/go;
1611 $table_alias .= '_' . $self->requested_class;
1612 $table_alias =~ s/\|/_/go;
1614 return $self->table_alias( $table_alias );
1619 return $self->{tsquery} if ($self->{tsquery});
1621 for my $atom (@{$self->query_atoms}) {
1623 $self->{tsquery} .= "\n" . ${spc} x 3 . $atom->sql;
1625 $self->{tsquery} .= $atom x 2;
1629 return $self->{tsquery};
1634 return $self->{tsquery_rank} if ($self->{tsquery_rank});
1637 for my $atom (@{$self->only_positive_atoms}) {
1638 push @atomlines, "\n" . ${spc} x 3 . $atom->sql;
1640 $self->{tsquery_rank} = join(' ||', @atomlines);
1641 $self->{tsquery_rank} = 'NULL::tsquery' unless $self->{tsquery_rank};
1642 return $self->{tsquery_rank};
1647 return $self->{rank} if ($self->{rank});
1649 my $rank_norm_map = $self->plan->QueryParser->custom_data->{rank_cd_weight_map};
1651 my $cover_density = 0;
1652 for my $norm ( keys %$rank_norm_map) {
1653 $cover_density += $$rank_norm_map{$norm} if ($self->plan->QueryParser->parse_tree->find_modifier($norm));
1656 my $weights = join(', ', @{$self->plan->QueryParser->search_class_weights($self->classname)});
1658 return $self->{rank} = "ts_rank_cd('{" . $weights . "}', " . $self->table_alias . '.index_vector, ' . $self->table_alias . ".tsq_rank, $cover_density)";