RDF::Q...derate(3pm)

💖 RDF::Query::Federate — the federated-query glow-up 💖

okay bestie, so this is the manual page for RDF::Query::Federate, a Perl module that lives in the User Contributed Perl Documentation section — you'll see it filed as RDF::Q...derate(3pm) when you go looking for it. ✨

---

🌸 NAME 🌸

RDF::Query::Federate — no cap, it's a subclass of RDF::Query built for efficient federated query execution. she federates, she queries, she executes. 💅

---

🎀 VERSION 🎀

This doc is describing RDF::Query::Federate version 2.919. noted, logged, timestamped. 🕰️

---

⚠️ STATUS ⚠️

bestie. listen. 😭 the API and functionality of this module should be considered deprecated. like, it's giving "still works but please don't build your whole personality on it."

If you genuinely need the functionality this module provides, the page says: please get in touch, at http://www.perlrdf.org/. that's the move. 🫶

---

✨ SYNOPSIS ✨

here's the vibe in code form, exactly as written:

my $service = RDF::Query::ServiceDescription->new( $url );
my $query = new RDF::Query::Federate ( $sparql );
$query->add_service( $service );
my $stream = $query->execute();

make the service description, make the federate query, add the service, execute. four steps, zero drama. 🦋

---

💜 DESCRIPTION 💜

...

...yeah. that's it. that's the whole description. the original really said "..." and dipped. 🙈 iconic honestly, we respect the brevity. 💀

---

👑 METHODS 👑

💫 new ( $query, \%options )

💫 new ( $query, $base_uri, $languri, $lang )

long story short: this hands you back a brand-new RDF::Query::Federate object for the $query you passed in. ✨

the query language defaults to SPARQLP — but you're not stuck with that, you can set it specifically by passing either $languri or $lang, and here's what's acceptable, exact strings and all:

$lang: 'rdql', 'sparql11', or 'sparql'

$languri: 'http://www.w3.org/TR/rdf-sparql-query/', or 'http://jena.hpl.hp.com/2003/07/query/RDQL'

pick your fighter. 🎀

---

💫 add_service ( $service_description )

this is the one that adds the service described by $service_description onto the query's list of data sources. you're literally collecting services like pokémon. gotta catch 'em all, then query across 'em. 🌈

---

💫 services

look. she's listed as a method. that's what the page gives us. that's what you get. 💅

---

💫 algebra_fixup ( $algebra, $bridge, $base_uri, $ns )

this one gets called inside the fixup method of ::Algebra classes. what does it return? either:

• an optimized ::Algebra object, all ready for execution 🔥
• or undef, in which case it'll be prepared for execution by the ::Algebra::* class itself.

(that's exactly what the original says — including the slightly unclosed parenthetical. we keep it real here. 🫶)

---

💖 AUTHOR 💖

Gregory Todd Williams <gwilliams@cpan.org> — the actual author, the main character, the one who wrote this. we love and respect. 👑

---

and that's the whole page bestie!! it was perl v5.40.1, dated 2025-08-18, and filed under RDF::Q...derate(3pm) — go forth, federate responsibly, and remember: deprecated doesn't mean unlovable. 💅✨💖