- Categories:
System functions (System Information)
SYSTEM$SHOW_DYNAMIC_TABLES_CREATED_FOR_RESHARING¶
When a consumer of a listing reshares the listing’s data into another region, Snowflake creates hidden dynamic tables to enable listing auto-fulfillment in the target region. This system function returns information about the hidden dynamic tables that Snowflake creates under the outgoing view to materialize imported data for cross-region resharing.
Use this function to:
Identify which imported objects have backing dynamic tables for a given outgoing view.
Inspect the most recent refresh times for those dynamic tables (for debugging or cost/health analysis).
- See also:
Syntax¶
Arguments¶
'view_name'The name of the outgoing view attached to a listing or share whose imported data is being auto-materialized into hidden dynamic tables for resharing.
You can pass a fully qualified view name, for example:
Returns¶
Returns a JSON string containing an array of objects. Each object represents a hidden dynamic table created under the specified view for resharing:
Field |
Type |
Description |
|---|---|---|
dtName |
STRING |
The fully qualified name of the hidden dynamic table nested under the outgoing view (for example,
|
dtSourceObject |
STRING |
The fully qualified name of the imported object (for example, |
dtRefreshStartTimeMillis |
NUMBER |
The epoch timestamp in milliseconds when the most recent refresh of this dynamic table started. Null if no refresh has occurred.
Convert with |
dtRefreshEndTimeMillis |
NUMBER |
The epoch timestamp in milliseconds when the most recent refresh of this dynamic table completed. Null if no refresh has occurred.
Convert with |
status |
STRING |
The status of the most recent refresh. Null if no refresh has occurred. Possible values: |
Usage notes¶
In the following scenarios, dynamic tables aren’t created and the function returns no rows:
The view doesn’t reference any imported databases.
The view uses imported data that is not eligible for resharing.
The view hasn’t yet been processed by the listing auto-fulfillment.
This function is intended for observability and debugging.
Examples¶
The following example retrieves the dynamic tables created for a reshared view:
To get a readable table with proper timestamps:
Sample output: