Struct FullyQualifiedName 

pub struct FullyQualifiedName {
    id: ObjectId,
    pub path: PathBuf,
    item_name: UnresolvedItemName,
}

Fully qualified name parsed from file path structure.

Represents the canonical database.schema.object name based on directory structure. File path format: <root>/<database>/<schema>/<object>.sql

This struct is created during object validation and is used to:

• Normalize statement names to be fully qualified
• Validate that SQL statement names match the directory structure
• Provide a consistent FQN for error messages and validation

Fields

id: ObjectId

path: PathBuf

item_name: UnresolvedItemName

Implementations

impl FullyQualifiedName

pub fn database(&self) -> &str

Get the database name.

FullyQualifiedName is constructed only for project-internal user objects, so the database is always present.

pub fn schema(&self) -> &str

Get the schema name.

pub fn object(&self) -> &str

Get the object name.

pub fn object_id(&self) -> &ObjectId

Get the ObjectId.

pub fn to_item_name(&self) -> UnresolvedItemName

Get the UnresolvedItemName for updating statement names.

pub fn with_names( path: &Path, object_name: &str, database: &str, schema: &str, ) -> Result<Self, ValidationError>

Create a FullyQualifiedName with explicit database and schema names.

Unlike TryFrom<(&Path, &str)> which derives names from the file path, this constructor accepts the names directly. This is needed when a suffix has been applied to the database name, so the path-derived name no longer matches the desired database name.

Trait Implementations

impl Clone for FullyQualifiedName

fn clone(&self) -> FullyQualifiedName

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FullyQualifiedName

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<ObjectId> for FullyQualifiedName

fn from(id: ObjectId) -> Self

Converts to this type from the input type.

impl PartialEq for FullyQualifiedName

fn eq(&self, other: &FullyQualifiedName) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<(&Path, &str)> for FullyQualifiedName

fn try_from(value: (&Path, &str)) -> Result<Self, Self::Error>

Extract fully qualified name from file path.

Path format: <root>/<database>/<schema>/<object>.sql Returns error if path structure is invalid.

type Error = ValidationError

The type returned in the event of a conversion error.

impl TryFrom<UnresolvedItemName> for FullyQualifiedName

type Error = &'static str

The type returned in the event of a conversion error.

fn try_from(value: UnresolvedItemName) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for FullyQualifiedName

impl StructuralPartialEq for FullyQualifiedName