Skip to content

Main Navigation

Guides
API Docs
Skills
Contributing

Appearance

Sidebar Navigation

Installation

Instructions
UNPKG

Configuration

Setup
Setup - Advanced
Setup - Legacy (Ember)
Older Packages (Ember Only)
- Overview
  Setup
  - Ember
    Universal

The Manual

Introduction
Requests
- Making Requests
  Typing Requests
  Using The Response
  Builders
  Handlers
Schemas
- Overview
  Resources
  - ResourceSchemas
    Legacy Mode
    Polaris Mode
  Object Schemas
  Simple Fields
  Relational Fields
  Complex Fields
  Traits
  Derivations
  Transformations
  Extensions
Relational Data
- Overview
  Configuration
  - Many To Many
    Many To None
    Many To One
    One To Many
    One To None
    One To One
  Features
  - Inverses
    Polymorphism
Caching
- Overview
  Key Terms
Reactivity
- Overview
  Async as Reactive State
  Control Flow
TypeScript
- Overview
  Configuration
  Installation
  Typing Includes
  Typing Models
  Why Brands
Debugging
- Overview
Mutations
- Overview
  Mutations
  Operations
Experiments
- Overview
  Storage Resources
Cookbook
- Index
  Auth Handlers
  Basic Usage
  Incremental Adoption Guide
  Naming Conventions
Community Resources

Skills

Schemas
- Define a Resource Schema
Requests
- Fetch and Cache Data
Contributors
- Start in a Fresh Worktree
  Fix at the Source

Linting

Overview

Migrating

V3/V4 to V5
Two Store Migration
Using Codemods

Contributing

Become A Contributor
Reporting Issues
Setting Up The Project
Project Architecture
Key Concepts
Writing Documentation
- Overview
  Documenting APIs
  Writing Guides
Submitting PRs
The RFC Process
Performing A Release
The Project Roadmap

API Docs

Universal
@warp-drive/core
- exports
  - ConfiguredStore
    RequestManager
    Store
    CacheHandler
    Fetch
    recordIdentifierFor
    setIdentifierForgetMethod
    setIdentifierGenerationMethod
    setIdentifierResetMethod
    setIdentifierUpdateMethod
    setKeyInfoForResource
    useRecommendedStore
  /build-config
  - exports
    babelPlugin
    setConfig
    /babel-macros
    exports
    macros
    /canary-features
    exports
    ENFORCE_STRICT_RESOURCE_FINALIZATION
    JSON_API_CACHE_VALIDATION_ERRORS
    /debugging
    exports
    DEBUG_RELATIONSHIP_NOTIFICATIONS
    LOG_CACHE
    LOG_CACHE_POLICY
    LOG_GRAPH
    LOG_IDENTIFIERS
    LOG_INSTANCE_CACHE
    LOG_METRIC_COUNTS
    LOG_MUTATIONS
    LOG_NOTIFICATIONS
    LOG_OPERATIONS
    LOG_PAYLOADS
    LOG_REACT_SIGNAL_INTEGRATION
    LOG_REQUEST_STATUS
    LOG_REQUESTS
    /Namespaces
    /t
    /deprecations
    exports
    DEPRECATE_COMPUTED_CHAINS
    DEPRECATE_EMBER_INFLECTOR
    DEPRECATE_LEGACY_IMPORTS
    DEPRECATE_MANY_ARRAY_DUPLICATES
    DEPRECATE_NON_STRICT_ID
    DEPRECATE_NON_STRICT_TYPES
    DEPRECATE_NON_UNIQUE_PAYLOADS
    DEPRECATE_RELATIONSHIP_REMOTE_UPDATE_CLEARING_LOCAL_STATE
    DEPRECATE_STORE_EXTENDS_EMBER_OBJECT
    DEPRECATE_TRACKING_PACKAGE
    DISABLE_7X_DEPRECATIONS
    ENABLE_LEGACY_REQUEST_METHODS
    ENABLE_LEGACY_SCHEMA_SERVICE
    /env
    /macros
  /configure
  - exports
    setupSignals
  /reactive
  - exports
    SchemaService
    Checkout
    fromIdentity
    checkout
    commit
    createRequestSubscription
    getPromiseState
    getRequestState
    instantiateRecord
    registerDerivations
    teardownRecord
    withDefaults
  /request
  - exports
    withBrand
    createDeferred
    getPromiseResult
    setPromiseResult
    withReactiveResponse
    withResponseType
  /signals
  - /-leaked
    exports
    defaultPageHints
    DISPOSE
    clearPaginationCache
    createPaginationLinksSubscription
    createPaginationSubscription
    getOrCreateInternalSignal
    getPaginationCache
    getPaginationLinks
    getPaginationState
    makeInitializer
    memoized
    notifyInternalSignal
    peekInternalSignal
    signal
    waitFor
  /store
  - exports
    DefaultCachePolicy
    parseCacheControl
  /types
  - /cache
    /aliases
    /change
    /mutations
    /operations
    /relationship
    /graph
    /identifier
    /json
    /raw
    /params
    /record
    exports
    createIncludeValidator
    /request
    exports
    EnableHydration
    SkipCache
    /runtime
    exports
    getRuntimeConfig
    setIsMaybeMirage
    setLogging
    /schema
    /concepts
    /fields
    exports
    /fields.type-test
    /schema-service
    /spec
    /document
    /error
    /json-api-raw
    /symbols
    exports
    RecordStore
    RequestSignature
    ResourceType
    TransformName
    Type
    /utils
  /utils
  - /string
@warp-drive/json-api
- exports
  - JSONAPICache
@warp-drive/utilities
- exports
  - buildBaseURL
    buildQueryParams
    filterEmpty
    setBuildURLConfig
    sortQueryParams
  /active-record
  - exports
    createRecord
    deleteRecord
    findRecord
    query
    updateRecord
  /derivations
  - exports
    concat
    /Namespaces
    /concat
  /handlers
  - /Handlers
    /AutoCompress
    /Gate
    /MetaDocHandler
    /Constants
    /MAX_URL_LENGTH
    /SupportsRequestStreams
    /TAB_ASSIGNED
    /TAB_ID
    /Utility Functions
    /addTraceHeader
    /assertInvalidUrlLength
  /json-api
  - exports
    createRecord
    deleteRecord
    findRecord
    postQuery
    query
    serializePatch
    serializeResources
    setBuildURLConfig
    updateRecord
  /rest
  - exports
    createRecord
    deleteRecord
    findRecord
    query
    updateRecord
  /string
  - exports
    dasherize
    camelize
    capitalize
    clear
    clearRules
    irregular
    loadIrregular
    loadUncountable
    plural
    pluralize
    resetToDefaults
    setMaxLRUCacheSize
    singular
    singularize
    uncountable
    underscore
@warp-drive/legacy
- exports
  - ConfiguredStore
    useLegacyStore
  /adapter
  - exports
    Adapter
    BuildURLMixin
    /error
    exports
    AbortError
    AdapterError
    ConflictError
    ForbiddenError
    InvalidError
    NotFoundError
    ServerError
    TimeoutError
    UnauthorizedError
    /json-api
    exports
    JSONAPIAdapter
    /rest
    exports
    RESTAdapter
  /compat
  - exports
    LegacyNetworkHandler
    adapterFor
    cleanup
    normalize
    pushPayload
    serializeRecord
    serializerFor
    /builders
    exports
    findAll
    findRecord
    query
    queryRecord
    saveRecord
    /extensions
    exports
    EmberArrayLikeExtension
    EmberObjectArrayExtension
    EmberObjectExtension
    /utils
    exports
    configureAssertFn
    configureMismatchReporter
    configureTypeNormalization
    expectId
    formattedId
    formattedType
    isEquivId
    isEquivType
  /model
  - exports
    Model
    attr
    belongsTo
    buildSchema
    hasMany
    instantiateRecord
    modelFor
    restoreDeprecatedModelRequestBehaviors
    teardownRecord
    /migration-support
    exports
    DelegatingSchemaService
    registerDerivations
    withDefaults
    withRestoredDeprecatedModelRequestBehaviors
  /model-fragments
  - exports
    Fragment
    FragmentArray
    FragmentArrayExtension
    FragmentExtension
    modelFor
    registerFragmentExtensions
    withArrayDefaults
    withFragmentArrayDefaults
    withFragmentDefaults
    withLegacy
  /serializer
  - exports
    Serializer
    /json
    exports
    JSONSerializer
    /json-api
    exports
    JSONAPISerializer
    /rest
    exports
    EmbeddedRecordsMixin
    RESTSerializer
    /transform
    exports
    BooleanTransform
    DateTransform
    NumberTransform
    StringTransform
    Transform
  /store
  - exports
    restoreDeprecatedStoreBehaviors
@warp-drive/experiments
- /data-worker
  - exports
    DataWorker
    CacheHandler
  /document-storage
  - exports
    DocumentStorage
  /image-fetch
  - exports
    ImageFetch
  /image-worker
  - exports
    ImageWorker
  /pagination
  /storage
  - exports
    CacheStorage
    DEFAULT_CACHE_ID
    CacheResource
    configureLocalStorage
    configureSessionStorage
    effect
    field
    getCacheStorage
    getLocalStorage
    getSessionStorage
    input
    LocalResource
    SessionResource
  /worker-fetch
  - exports
    WorkerFetch
Frameworks
@warp-drive/ember
- exports
  - /Components
    /Await
    /Request
    /Throw
  /experiments
  - exports
    EachLink
    Paginate
  /install
  - exports
    buildSignalConfig
@warp-drive/react
- exports
  - WatcherContext
    ReactiveContext
    Request
    StoreProvider
    useStore
  /install
  - exports
    buildSignalConfig
    settled
Tooling
@warp-drive/holodeck
- exports
  - MockServerHandler
    getIsRecording
    installAdapterFor
    mock
    setConfig
    setIsRecording
    setTestId
  /mock
  - exports
    DELETE
    GET
    HEAD
    PATCH
    POST
    PUT
@warp-drive/schema-dsl
- /Entity Decorators
  - /ObjectSchema
    /Resource
    /trait
    /Trait
  /Field Decorators
  - /alias
    /array
    /attribute
    /belongsTo
    /createonly
    /derived
    /editonly
    /field
    /hash
    /hasMany
    /id
    /local
    /object
    /optional
    /readonly
    /schemaArray
    /schemaObject
eslint-plugin-warp-drive
- exports
  - export=
  /recommended
  - exports
    export=
  /rules
  - /no-create-record-rerender
    exports
    export=
    /no-external-request-patterns
    exports
    export=
    /no-invalid-relationships
    exports
    export=
    /no-invalid-resource-ids
    exports
    export=
    /no-invalid-resource-types
    exports
    export=
    /no-legacy-imports
    exports
    export=
    /no-legacy-request-patterns
    exports
    export=
    /template-always-use-request-content
    exports
    export=
@warp-drive/memory-alpha

Legacy Packages

@ember-data/adapter
- /error
  /json-api
  /rest
@ember-data/active-record
- /request
@ember-data/legacy-compat
- /builders
  /utils
@ember-data/model
- /hooks
  /migration-support
@ember-data/json-api
- /request
@ember-data/store
- /configure
  /types
@ember-data/graph
@ember-data/request
- /fetch
@ember-data/request-utils
- exports
  - exports
    LifetimesService
  /deprecation-support
  /handlers
  /string
@ember-data/rest
- /request
@ember-data/serializer
- /json
  /json-api
  /rest
  /transform
@ember-data/tracking
- exports
  - exports
    buildSignalConfig
@warp-drive/core-types
- /cache
  /graph
  /identifier
  /json
  - /raw
  /params
  /record
  /request
  /runtime
  /schema
  - /concepts
    /fields
  /spec
  - /document
    /error
    /json-api-raw
  /symbols
  /utils
@warp-drive/build-config
- exports
  - exports
    babelPlugin
    setConfig
  /babel-macros
  - exports
    macros
  /canary-features
  - exports
    ENFORCE_STRICT_RESOURCE_FINALIZATION
    JSON_API_CACHE_VALIDATION_ERRORS
  /debugging
  - exports
    DEBUG_RELATIONSHIP_NOTIFICATIONS
    LOG_CACHE
    LOG_CACHE_POLICY
    LOG_GRAPH
    LOG_IDENTIFIERS
    LOG_INSTANCE_CACHE
    LOG_METRIC_COUNTS
    LOG_MUTATIONS
    LOG_NOTIFICATIONS
    LOG_OPERATIONS
    LOG_PAYLOADS
    LOG_REACT_SIGNAL_INTEGRATION
    LOG_REQUEST_STATUS
    LOG_REQUESTS
  /deprecations
  - exports
    DEPRECATE_COMPUTED_CHAINS
    DEPRECATE_EMBER_INFLECTOR
    DEPRECATE_LEGACY_IMPORTS
    DEPRECATE_MANY_ARRAY_DUPLICATES
    DEPRECATE_NON_STRICT_ID
    DEPRECATE_NON_STRICT_TYPES
    DEPRECATE_NON_UNIQUE_PAYLOADS
    DEPRECATE_RELATIONSHIP_REMOTE_UPDATE_CLEARING_LOCAL_STATE
    DEPRECATE_STORE_EXTENDS_EMBER_OBJECT
    DEPRECATE_TRACKING_PACKAGE
    DISABLE_7X_DEPRECATIONS
    ENABLE_LEGACY_REQUEST_METHODS
    ENABLE_LEGACY_SCHEMA_SERVICE
@warp-drive/schema-record

On this page

Are you an LLM? You can read better optimized documentation at /guides/the-manual/schemas/relational-fields.md for this page in Markdown format

Relational Fields

Edit this page

Pager

Previous pageSimple Fields

Next pageComplex Fields

Released under the MIT License.

Setup

Resources

Configuration

Features

exports

/build-config

exports

/babel-macros

exports

/canary-features

exports

/debugging

exports

/Namespaces

/deprecations

exports

/configure

exports

/reactive

exports

/request

exports

/signals

/-leaked

exports

/store

exports

/types

/cache

/json

/record

exports

/request

exports

/runtime

exports

/schema

/fields

/spec

/symbols

exports

/utils

exports

exports

/active-record

exports

/derivations

exports

/Namespaces

/handlers

/Handlers

/Constants

/Utility Functions

/json-api

exports

/rest

exports

/string

exports

exports

/adapter

exports

/error

exports

/json-api

exports

/rest

exports

/compat

exports

/builders

exports

/extensions

exports

/utils

exports

/model

exports

/migration-support

exports