Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 2 additions & 2 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -349,8 +349,8 @@ async-compression = { git = "https://github.com/MaterializeInc/async-compression

# Custom iceberg features for mz
# All changes should go to the `mz_changes` branch.
iceberg = { git = "https://github.com/MaterializeInc/iceberg-rust.git", rev = "3e77059b20d3" }
iceberg-catalog-rest = { git = "https://github.com/MaterializeInc/iceberg-rust.git", rev = "3e77059b20d3" }
iceberg = { git = "https://github.com/MaterializeInc/iceberg-rust.git", rev = "375a44a45bff" }
iceberg-catalog-rest = { git = "https://github.com/MaterializeInc/iceberg-rust.git", rev = "375a44a45bff" }

# Custom duckdb crate to support mz needs
# All changes should go to the `mz_changes` branch.
Expand Down
4 changes: 2 additions & 2 deletions LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Business Source License 1.1

Licensor: Materialize, Inc.

Licensed Work: Materialize Version 20260115
Licensed Work: Materialize Version 20260116
The Licensed Work is © 2026 Materialize, Inc.

Additional Use Grant: Within a single installation of the Licensed Work,
Expand All @@ -39,7 +39,7 @@ Additional Use Grant: Within a single installation of the Licensed Work,
whose definitions are controlled by such third
parties.

Change Date: January 15, 2030
Change Date: January 16, 2030

Change License: Apache License, Version 2.0

Expand Down
2 changes: 1 addition & 1 deletion doc/user/content/concepts/clusters.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ The following provides some general guidelines for clusters. See also

### Three-tier architecture in production

{{% best-practices/architecture/three-tier %}}
{{% include-from-yaml data="best_practices_details" name="architecture-three-tier" %}}

See also [Operational guidelines](/manage/operational-guidelines/).

Expand Down
8 changes: 4 additions & 4 deletions doc/user/content/concepts/indexes.md
Original file line number Diff line number Diff line change
Expand Up @@ -215,8 +215,8 @@ CREATE INDEX idx_orders_view_qty_price on orders_view (quantity, price);

### Indexes on views vs. materialized views

{{% views-indexes/table-usage-pattern-intro %}}
{{% views-indexes/table-usage-pattern %}}
{{% include-from-yaml data="index_view_details" name="table-usage-pattern-intro" %}}
{{% include-from-yaml data="index_view_details" name="table-usage-pattern" %}}
{{% include-md file="shared-content/mat-view-use-cases.md" %}}

### Indexes and query optimizations
Expand All @@ -229,11 +229,11 @@ query performance](/transform-data/optimization/), such as:
- Provide fast random access for lookup queries (i.e., selecting individual
keys).

{{% views-indexes/index-query-optimization-specific-instances %}}
{{% include-from-yaml data="index_view_details" name="index-query-optimization-specific-instances" %}}

### Best practices

{{% views-indexes/index-best-practices %}}
{{% include-from-yaml data="index_view_details" name="index-best-practices" %}}

## Related pages

Expand Down
4 changes: 2 additions & 2 deletions doc/user/content/concepts/views.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,9 +145,9 @@ See also:

## Indexed views vs. materialized views

{{% views-indexes/table-usage-pattern-intro %}}
{{% include-from-yaml data="index_view_details" name="table-usage-pattern-intro" %}}

{{% views-indexes/table-usage-pattern %}}
{{% include-from-yaml data="index_view_details" name="table-usage-pattern" %}}

{{% include-md file="shared-content/mat-view-use-cases.md" %}}

Expand Down
2 changes: 1 addition & 1 deletion doc/user/content/get-started/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ SQL patterns enabled by streaming like [**Change Data Capture
filters**](/sql/patterns/temporal-filters/), and
[**subscriptions**](/sql/subscribe/).

{{% materialize-postgres-compatibility %}}
{{% include-from-yaml data="materialize_details" name="postgres-compatibility" %}}

### Real-time data ingestion

Expand Down
2 changes: 1 addition & 1 deletion doc/user/content/get-started/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -559,7 +559,7 @@ views incrementally update the view results. Materialized views persist the
query results in durable storage and is available across clusters while indexes
maintain the view results in memory within a single cluster.

{{% views-indexes/table-usage-pattern %}}
{{% include-from-yaml data="index_view_details" name="table-usage-pattern" %}}

The quickstart used an index since:

Expand Down
3 changes: 2 additions & 1 deletion doc/user/content/ingest-data/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,8 @@ guidelines for upsert sources.

### Scheduling

{{% best-practices/ingest-data/scheduling %}}
{{% include-from-yaml data="best_practices_details"
name="ingest-data-scheduling" %}}

### Dedicate a cluster for the sources

Expand Down
12 changes: 6 additions & 6 deletions doc/user/content/ingest-data/postgres/alloydb.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ to Materialize using the [PostgreSQL source](/sql/create-source/postgres/).

## Before you begin

{{% postgres-direct/before-you-begin %}}
{{% include-from-yaml data="ingest_postgres" name="before-you-begin" %}}

If you don't already have an AlloyDB instance, creating one involves several
steps, including configuring your cluster and setting up network connections.
Expand All @@ -38,7 +38,7 @@ To enable logical replication in AlloyDB, see the

### 2. Create a publication and a replication user

{{% postgres-direct/create-a-publication-other %}}
{{% include-from-yaml data="ingest_postgres" name="create-a-publication-other" %}}

## B. (Optional) Configure network security

Expand Down Expand Up @@ -187,7 +187,7 @@ scenarios, we recommend separating your workloads into multiple clusters for
[resource isolation](/sql/create-cluster/#resource-isolation).
{{< /note >}}

{{% postgres-direct/create-a-cluster %}}
{{% include-from-yaml data="ingest_postgres" name="create-a-cluster" %}}

### 2. Create a connection

Expand Down Expand Up @@ -255,15 +255,15 @@ your networking configuration.

### 4. Monitor the ingestion status

{{% postgres-direct/check-the-ingestion-status %}}
{{% include-from-yaml data="ingest_postgres" name="check-the-ingestion-status" %}}

### 5. Right-size the cluster

{{% postgres-direct/right-size-the-cluster %}}
{{% include-from-yaml data="ingest_postgres" name="right-size-the-cluster" %}}

## D. Explore your data

{{% postgres-direct/next-steps %}}
{{% include-from-yaml data="ingest_postgres" name="next-steps" %}}

## Considerations

Expand Down
12 changes: 6 additions & 6 deletions doc/user/content/ingest-data/postgres/amazon-aurora.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ to Materialize using the [PostgreSQL source](/sql/create-source/postgres/).

## Before you begin

{{% postgres-direct/before-you-begin %}}
{{% include-from-yaml data="ingest_postgres" name="before-you-begin" %}}

{{< warning >}}
There is a known issue with Aurora PostgreSQL 16.1 that can cause logical replication to fail with the following error:
Expand Down Expand Up @@ -49,7 +49,7 @@ Materialize.

### 2. Create a publication and a replication user

{{% postgres-direct/create-a-publication-aws %}}
{{% include-from-yaml data="ingest_postgres" name="create-a-publication-aws" %}}

## B. (Optional) Configure network security

Expand Down Expand Up @@ -327,7 +327,7 @@ scenarios, we recommend separating your workloads into multiple clusters for
{{< /note >}}


{{% postgres-direct/create-a-cluster %}}
{{% include-from-yaml data="ingest_postgres" name="create-a-cluster" %}}

### 2. Create a connection

Expand Down Expand Up @@ -435,15 +435,15 @@ your networking configuration.

### 4. Monitor the ingestion status

{{% postgres-direct/check-the-ingestion-status %}}
{{% include-from-yaml data="ingest_postgres" name="check-the-ingestion-status" %}}

### 5. Right-size the cluster

{{% postgres-direct/right-size-the-cluster %}}
{{% include-from-yaml data="ingest_postgres" name="right-size-the-cluster" %}}

## D. Explore your data

{{% postgres-direct/next-steps %}}
{{% include-from-yaml data="ingest_postgres" name="next-steps" %}}

## Considerations

Expand Down
12 changes: 6 additions & 6 deletions doc/user/content/ingest-data/postgres/amazon-rds.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ to Materialize using the [PostgreSQL source](/sql/create-source/postgres/).

## Before you begin

{{% postgres-direct/before-you-begin %}}
{{% include-from-yaml data="ingest_postgres" name="before-you-begin" %}}

## A. Configure Amazon RDS

Expand Down Expand Up @@ -97,7 +97,7 @@ As a first step, you need to make sure logical replication is enabled.

### 2. Create a publication and a replication user

{{% postgres-direct/create-a-publication-aws %}}
{{% include-from-yaml data="ingest_postgres" name="create-a-publication-aws" %}}

## B. (Optional) Configure network security

Expand Down Expand Up @@ -373,7 +373,7 @@ scenarios, we recommend separating your workloads into multiple clusters for
[resource isolation](/sql/create-cluster/#resource-isolation).
{{< /note >}}

{{% postgres-direct/create-a-cluster %}}
{{% include-from-yaml data="ingest_postgres" name="create-a-cluster" %}}

### 2. Create a connection

Expand Down Expand Up @@ -496,15 +496,15 @@ your networking configuration.

### 4. Monitor the ingestion status

{{% postgres-direct/check-the-ingestion-status %}}
{{% include-from-yaml data="ingest_postgres" name="check-the-ingestion-status" %}}

### 5. Right-size the cluster

{{% postgres-direct/right-size-the-cluster %}}
{{% include-from-yaml data="ingest_postgres" name="right-size-the-cluster" %}}

## D. Explore your data

{{% postgres-direct/next-steps %}}
{{% include-from-yaml data="ingest_postgres" name="next-steps" %}}

## Considerations

Expand Down
12 changes: 6 additions & 6 deletions doc/user/content/ingest-data/postgres/azure-db.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ to Materialize using the [PostgreSQL source](/sql/create-source/postgres/).

## Before you begin

{{% postgres-direct/before-you-begin %}}
{{% include-from-yaml data="ingest_postgres" name="before-you-begin" %}}

## A. Configure Azure DB

Expand All @@ -34,7 +34,7 @@ To enable logical replication in Azure DB, see the

### 2. Create a publication and a replication user

{{% postgres-direct/create-a-publication-other %}}
{{% include-from-yaml data="ingest_postgres" name="create-a-publication-other" %}}

## B. (Optional) Configure network security

Expand Down Expand Up @@ -172,7 +172,7 @@ scenarios, we recommend separating your workloads into multiple clusters for
[resource isolation](/sql/create-cluster/#resource-isolation).
{{< /note >}}

{{% postgres-direct/create-a-cluster %}}
{{% include-from-yaml data="ingest_postgres" name="create-a-cluster" %}}

### 2. Create a connection

Expand Down Expand Up @@ -240,15 +240,15 @@ your networking configuration.

### 4. Monitor the ingestion status

{{% postgres-direct/check-the-ingestion-status %}}
{{% include-from-yaml data="ingest_postgres" name="check-the-ingestion-status" %}}

### 5. Right-size the cluster

{{% postgres-direct/right-size-the-cluster %}}
{{% include-from-yaml data="ingest_postgres" name="right-size-the-cluster" %}}

## D. Explore your data

{{% postgres-direct/next-steps %}}
{{% include-from-yaml data="ingest_postgres" name="next-steps" %}}

## Considerations

Expand Down
Loading