Overview of sdk-backend-spi

Home > @gooddata/sdk-backend-spi

sdk-backend-spi package

This package provides definitions of the Service Provider Interface (SPI) for the Analytical Backend.

Remarks

The interface defines functionality to be implemented for a particular backend to be used in GoodData.UI. The Analytical Backend SPI for the GoodData platform (codename bear in @gooddata/sdk-backend-bear) is fully implemented. The Analytical Backend SPI for GoodData Cloud and GoodData.CN (joint codename tiger in @gooddata/sdk-backend-tiger) is almost fully implemented.

Classes

Class	Description
ContractExpired	This exception is thrown when a contract has expired, for example if a plan's trial period has ended
DataTooLargeError	This exception MUST be thrown when backend execution identifies that there is too much data to process for the execution and refuses to proceed.
LimitReached	This exception is thrown when the limit of objects that can be created on backend is reached, for example if no more workspaces can be created because of the plan limits.
NoDataError	This exception MUST be thrown when the backend execution identifies that there is no data to calculate.
NotAuthenticated	This exception is thrown when client code triggers an operation which requires authentication but the client code did not provide credentials or the credentials are invalid.
NotImplemented	This exception is thrown when client code asks Analytical Backend to exercise a feature that is not implemented yet.
NotSupported	This exception is thrown when client code asks Analytical Backend to exercise an unsupported feature.
ProtectedDataError	This exception MUST be thrown when backend execution identifies that the data to calculate results for is protected and the caller lacks the sufficient authorization.
TimeoutError	This error means that during a repeated polling for some resource, we did not reach 200 response within the certain number of attempts/time.
UnexpectedError	This exception MUST be thrown when the unexpected happens. This is a last-resort error type that SHOULD be used if the erroneous state cannot be categorized in a better way.
UnexpectedResponseError	This exception MUST be thrown when communication with the backend encounters an unexpected response status code and it cannot handle or categorize it to a known, domain-specific error.

Abstract Classes

Abstract Class	Description
AnalyticalBackendError	Superclass for all exceptions that can occur in Analytical Backend.

Functions

Function	Description
isAnalyticalBackendError(obj)	Type guard checking whether input is an instance of AnalyticalBackendError
isContractExpired(obj)	Type guard checking whether input is an instance of ContractExpired
isDataTooLargeError(obj)	Type guard checking whether input is an instance of DataTooLargeError
isElementsQueryOptionsElementsByPrimaryDisplayFormValue(obj)	Type guard checking whether the object is an instance of IElementsQueryOptionsElementsByPrimaryDisplayFormValue.
isElementsQueryOptionsElementsByValue(obj)	Type guard checking whether the object is an instance of IElementsQueryOptionsElementsByValue.
isLimitReached(obj)	Type guard checking whether input is an instance of LimitReached
isNoDataError(obj)	Type guard checking whether input is an instance of NoDataError
isNotAuthenticated(obj)	Type guard checking whether input is an instance of NotAuthenticated
isNotImplemented(obj)	Type guard checking whether input is an instance of NotImplemented
isNotSupported(obj)	Type guard checking whether input is an instance of NotSupported
isProtectedDataError(obj)	Type guard checking whether input is an instance of ProtectedDataError
isUnexpectedError(obj)	Type guard checking whether input is an instance of UnexpectedResponseError
isUnexpectedResponseError(obj)	Type guard checking whether input is an instance of UnexpectedResponseError
isValueBasedElementsQueryOptionsElements(obj)	Type guard checking whether the object is an instance of IElementsQueryOptionsElementsByValue or IElementsQueryOptionsElementsByPrimaryDisplayFormValue.
prepareExecution(backend, definition)	Prepares execution of the provided definition against a backend.

Interfaces

Interface	Description
IAnalyticalBackend	The root of the Analytical Backend SPI.
IAnalyticalBackendConfig	Specifies platform agnostic configuration of an analytical backend.
IAnalyticalWorkspace	Represents an analytical workspace hosted on a backend.
IAttributeElementExpressionToken	Parsed MAQL token referencing an attribute element.
IAuthenticatedPrincipal	Describes user, which is currently authenticated to the backend.
IAuthenticationContext	Describes context in which the authentication is done.
IAuthenticationProvider	Defines authentication provider to use when instance of IAnalyticalBackend discovers that the current session is not authentication.
IBackendCapabilities	Analytical Backend communicates its capabilities via objects of this type. In return, the capabilities can then be used by applications to enable / disable particular features.
IBracketExpressionToken	Parsed MAQL bracket.
ICancelable	(BETA) Interface that implements aborting of requests
ICommentExpressionToken	Parsed MAQL comment text.
IDataView	A view on the calculated data.
IElementsQuery	Service to query valid attribute elements for particular display form.
IElementsQueryAttributeFilter	Attribute filter limiting the elements.
IElementsQueryFactory	The attribute itself contains no view data, it's just a sequence of id's.
IElementsQueryOptions	Configuration options for querying attribute elements
IElementsQueryOptionsElementsByPrimaryDisplayFormValue	Specification of particular elements to load in IElementsQueryOptions using the values of the primary display form related to the attribute the requested display form is from.
IElementsQueryOptionsElementsByUri	Specification of particular elements to load in IElementsQueryOptions using their URIs.
IElementsQueryOptionsElementsByValue	Specification of particular elements to load in IElementsQueryOptions using their values.
IEntitlements	Provides functions to obtain entitlements
IExecutionFactory	Execution factory provides several methods to create a prepared execution from different types of inputs.
IExecutionResult	Represents results of execution done with particular definition.
IExportConfig	Configuration for exports of results into XLSX or CSV.
IExportResult	Result of export is an object URL pointing to a Blob of downloaded data attached to the current window instance. The result also contains name of the downloaded file provided by the backend export service. method must be used when object URL is no longer needed to release the blob memory.
IFilterElementsQuery	Service to query valid filter elements for particular filter.
IGetInsightOptions	Configuration options for getting a single insight.
IGetVisualizationClassesOptions	Additional options for the IWorkspaceInsightsService.getVisualizationClasses() function.
IInsightReferences	Contains information about objects that may be referenced by an insight.
IInsightReferencing	Contains information about objects that may be referencing an insight.
IInsightsQueryOptions	Configuration options for querying insights
IMeasureReferencing	Contains information about objects that may be referencing an measure. IWorkspaceMeasuresService.getMeasureReferencingObjects() function.
IObjectExpressionToken	Parsed MAQL token referencing a metadata object.
IOrganization	Represents an organization that services analytical workspaces.
IOrganizations	Provides functions to obtain IOrganization instances
IOrganizationSettingsService	This service provides access to organization settings
IOrganizationStylingService	This service provides access to organization styling settings such as theme.
IPagedResource	Interface to interact with paged asynchronous resources
IPreparedExecution	Prepared execution already knows what data to calculate and allows to specify how the data should be sorted and shaped into dimensions.
ISecuritySettingsService	This service provides access to security settings defined on backend.
ITextExpressionToken	Parsed MAQL text.
IUserService	Represents a user. It is an entry point to various services that can be used to inspect and modify the user.
IUserSettings	Settings for particular user.
IUserSettingsService	This query service provides access to feature flags that are in effect for particular user.
IUserWorkspaceSettings	Settings for particular combination of user and workspace.
IWorkspaceAttributesService	Service for querying additional attributes and attribute display forms data, and their elements.
IWorkspaceCatalog	Instance of workspace catalog with loaded items
IWorkspaceCatalogAvailableItemsFactory	Service to obtain only valid items for a particular execution or insight.
IWorkspaceCatalogFactory	Catalog is useful for: - Interactive insight/execution creation - Exporting execution model for a specific workspace
IWorkspaceCatalogFactoryMethods	Common methods for catalog configuration
IWorkspaceCatalogFactoryOptions	Configuration options for querying catalog items
IWorkspaceCatalogMethods	Common methods to obtain catalog items
IWorkspaceCatalogWithAvailableItems	Instance of workspace catalog with loaded available items.
IWorkspaceCatalogWithAvailableItemsFactoryOptions	Configuration options for querying catalog available items
IWorkspaceDatasetsService	Service for querying workspace datasets
IWorkspaceDescriptor	Workspace descriptor contains details about the analytical workspace.
IWorkspaceFactsService	Service for querying additional facts data. If you want to query facts themselves, use catalog IWorkspaceCatalogFactory
IWorkspaceInsightsService	Service to query, update or delete insights, and other methods related to insights. Check IInsight for more details.
IWorkspaceMeasuresService	Service for create, update or delete measures and querying additional measures data. If you want to query measures themselves, use catalog IWorkspaceCatalogFactory
IWorkspacePermissionsService	Service to query workspace permissions
IWorkspaceSettings	Settings for particular workspace.
IWorkspaceSettingsService	This query service provides access to feature flags that are in effect for particular workspace.
IWorkspacesQuery	Query to retrieve available workspaces.
IWorkspacesQueryFactory	Factory providing creating queries used to get available workspaces.
IWorkspaceStylingService	This service provides access to workspace styling settings such as color palette.
IWorkspaceUsersQuery	Service to query users for current workspace
IWorkspaceUsersQueryOptions	Configuration options for querying users

Variables

Variable	Description
AnalyticalBackendErrorTypes	Types of errors that can be raised by Analytical Backends.

Type Aliases

Type Alias	Description
AnalyticalBackendFactory	Factory function to create new instances of Analytical Backend realization using both platform agnostic and platform specific configuration.
AuthenticationFlow	Implementation of different backends MAY indicate through this structure where to redirect the browser in order to start authentication flow.
CancelableOptions	(BETA) Options that is used for propagation cancellation signal / abort signal
ElementsQueryOptionsElementsSpecification	Specification of particular elements to load in IElementsQueryOptions.
ErrorConverter	Error converter
FilterWithResolvableElements	Only for these filter types makes sense to resolve their elements
IDateFilterConfigsQueryResult	Paged result of valid element query. Last page of data returns empty items.
IElementsQueryResult	Paged result of valid element query. Last page of data returns empty items.
IInsightsQueryResult	Queried insights are returned in a paged representation.
IMeasureExpressionToken	Token representing part of parsed MAQL measure expression.
InsightOrdering	Ordering options for insight query.
InsightReferenceTypes
IWorkspacesQueryResult	Paged resource with results of a workspace query.
IWorkspaceUsersQueryResult	Paged result of users query. Last page of data returns empty items.
NotAuthenticatedHandler	Type of the function to be called when the Analytical Backend raises a NotAuthenticated error. See IAuthenticationProvider.onNotAuthenticated for more details.
NotAuthenticatedReason	More detailed reason of the NotAuthenticated error.
SupportedInsightReferenceTypes	List of currently supported types of references that can be retrieved using the IWorkspaceInsightsService.getInsightReferencedObjects() function.
ValidationContext	The type of context in which is tested URL valid.