Docs
Pricing
Blog
About
Sign In
Get Started
Docs
Pricing
Blog
About
Sign In
Get Started
Getting started
Learn about Materialize
Concepts
Reaction time, freshness, and query latency
Namespaces
Sources
Snapshotting
Views
Indexes
Clusters
Hydration
Sinks
Arrangements
Reference architectures
Live context graph
Ingest data
PostgreSQL
AlloyDB
Amazon Aurora
Amazon RDS
Azure DB
Google Cloud SQL
Neon
Self-hosted PostgreSQL
Ingest from a dedicated replica
Ingest from partitioned tables
Guide: Handle upstream schema changes with zero downtime
Troubleshoot
Slot overcompacted
Replication slot is active
Connection closed
FAQ: PostgreSQL sources
MySQL
Amazon Aurora
Amazon RDS
Azure DB
Google Cloud SQL
Self-hosted
Guide: Handle upstream schema changes with zero downtime
Snapshot parallelism
Troubleshoot
Received out of order GTIDs
SQL Server
Azure SQL Database
Self-hosted SQL Server
Guide: Handle upstream schema changes with zero downtime
Kafka
Amazon MSK
Confluent Cloud
Self-hosted Kafka
WarpStream
Guide: Handle upstream schema changes with zero downtime
MongoDB
CockroachDB
Use Kafka and changefeeds
Redpanda
Self-hosted Redpanda
Redpanda Cloud
Webhooks
Quickstart
Change included headers
Amazon EventBridge
HubSpot
RudderStack
Segment
SnowcatCloud
Stripe
Network configuration
Static IP addresses (Cloud-only)
AWS PrivateLink connections (Cloud-only)
SSH tunnel connections
Patterns
Absorb upstream schema changes
Performance and scaling
Monitor data ingestion
Troubleshoot ingestion
Build data products
Idiomatic Materialize SQL
ANY()
equi-join condition
NOT IN
subquery
First value in group
Lag over
Last value in group
Lead over
mz_now() expressions
Top-K in group
Appendix
Idiomatic Materialize SQL chart
Window function to idiomatic Materialize
Example data: items and orders
Update materialized views
Replace materialized views
Dictionary compression
Patterns
Use an ontology table
Partitioning and filter pushdown
Percentile calculation
Rules execution engine
Temporal filters (time windows)
Optimize performance
Monitor freshness
Troubleshoot freshness
Troubleshoot dataflows
FAQ: indexes
Serve results
SELECT
and
SUBSCRIBE
Durable subscriptions
Isolation levels
Use foreign data wrapper (FDW)
SQL clients
Client libraries
Go
Java
Node.js
PHP
Python
Ruby
Rust
Connection pooling
ADBC (Arrow Database Connectivity)
HTTP API
WebSocket API
Use BI/data collaboration tools
Deepnote
Hex
Metabase
Power BI
Tableau
Looker
Excel
Troubleshoot query performance
Export data
Kafka and Redpanda
Apache Iceberg
AWS S3 Tables
GCP BigLake
Databricks on AWS
Amazon S3
S3-compatible object storage
Elasticsearch
OpenSearch
turbopuffer
Census
Snowflake
Troubleshoot sinks
Developer tools
Setup agents
Install skills
MCP server for agents
Available tools
Agent endpoint configuration
MCP server for developers
Available tools
Endpoint configuration
Troubleshoot MCP server
mz-deploy
Getting started
Project structure
Infrastructure
Local development
Editor setup
AI agent setup
Deployments
Stable APIs
Profiles
dbt
Getting started
Development workflows
Blue-green deployment
Slim deployments
Terraform
Getting started
Manage Materialize resources
Manage cloud resources
Manage privileges
Appendix: External secret stores
Develop locally with the Materialize Emulator
mz
- Materialize CLI
Installation
Configuration
mz
reference
mz app-password
mz config
mz profile
mz region
mz secret
mz sql
mz user
mz-debug
debug tool
mz-debug Self-Managed
mz-debug Emulator
Console
Create new
SQL Shell
Database object explorer
Clusters
Integrations
Monitor
Admin (Cloud-only)
Connect (Cloud-only)
User profile
Clusters
Operational guidelines
Appendix: Alternative cluster architectures
System clusters
Observability
Cloud
Datadog
Grafana
Set alerts
Self-Managed
How logs and metrics are stored and delivered
Grafana
Datadog
Honeycomb
OpenTelemetry
Google Cloud Monitoring
Prometheus remote write
Set alerts
Replica resource usage
Essential metrics
Appendix: metrics
Security
Cloud
User and service accounts
Invite users
Create service accounts
Configure single sign-on (SSO)
Sync identity provider groups to database roles
Access control (role-based)
Manage database roles
Manage network policies
Self-Managed
Authentication
Single sign-on (SSO)
Migrate to SSO
Access control
Manage database roles
RBAC reference
Appendix: privileges
Appendix: privileges by commands
Appendix: built-in roles
Materialize Cloud
Usage & billing
Disaster recovery
Materialize Cloud DR characteristics
Customer responsibility model
M.1 to cc size mapping
Free trials
Materialize Self-Managed
Installation
Install Self-Managed Materialize
Install locally on kind
Install on AWS
Install on Azure
Install on GCP
Upgrade
Upgrade on kind
Upgrade on AWS
Upgrade on Azure
Upgrade on GCP
Upgrade notes
Adopt the v1 CRD
Deployment guidelines
AWS deployment guidelines
Azure deployment guidelines
GCP deployment guidelines
Resize node pools
GKE node pool upgrades
Materialize Operator configuration
Materialize CRD field descriptions
v1
v1alpha1
Configure system parameters
Query History
Troubleshoot
FAQ
Self-Managed release versions
Appendix
Prepare for swap and upgrade to v26.0
Cluster sizes
Release notes
Release schedule
SQL and catalog reference
SQL commands
ALTER CLUSTER
ALTER CLUSTER REPLICA
ALTER CONNECTION
ALTER DATABASE
ALTER DEFAULT PRIVILEGES
ALTER INDEX
ALTER MATERIALIZED VIEW
ALTER NETWORK POLICY (Cloud)
ALTER ROLE
ALTER SCHEMA
ALTER SECRET
ALTER SINK
ALTER SOURCE
ALTER SYSTEM RESET
ALTER SYSTEM SET
ALTER TABLE
ALTER TYPE
ALTER VIEW
BEGIN
CLOSE
COMMENT ON
COMMIT
COPY FROM
COPY TO
CREATE CLUSTER
CREATE CLUSTER REPLICA
CREATE CONNECTION
CREATE DATABASE
CREATE INDEX
CREATE MATERIALIZED VIEW
CREATE NETWORK POLICY (Cloud)
CREATE ROLE
CREATE SCHEMA
CREATE SECRET
CREATE SINK
Kafka/Redpanda
Iceberg
CREATE SOURCE
Kafka/Redpanda (New Syntax)
MySQL (New Syntax)
PostgreSQL (New Syntax)
SQL Server (New Syntax)
Webhook
Legacy Syntax
Kafka/Redpanda (Legacy Syntax)
MySQL (Legacy Syntax)
PostgreSQL (Legacy Syntax)
SQL Server (Legacy Syntax)
Load generator
CREATE TABLE
PostgreSQL source table
MySQL source table
SQL Server source table
Kafka source table
Read-write table
CREATE TYPE
CREATE VIEW
DEALLOCATE
DECLARE
DELETE
DISCARD
DROP CLUSTER
DROP CLUSTER REPLICA
DROP CONNECTION
DROP DATABASE
DROP INDEX
DROP MATERIALIZED VIEW
DROP NETWORK POLICY (Cloud)
DROP OWNED
DROP ROLE
DROP SCHEMA
DROP SECRET
DROP SINK
DROP SOURCE
DROP TABLE
DROP TYPE
DROP USER
DROP VIEW
EXECUTE
EXECUTE UNIT TEST
EXPLAIN ANALYZE
EXPLAIN FILTER PUSHDOWN
EXPLAIN PLAN
EXPLAIN SCHEMA
EXPLAIN TIMESTAMP
FETCH
GRANT PRIVILEGE
GRANT ROLE
INSERT
PREPARE
REASSIGN OWNED
RESET
REVOKE PRIVILEGE
REVOKE ROLE
ROLLBACK
SELECT
Joins
Recursive CTEs
SET
SHOW
SHOW CLUSTER REPLICAS
SHOW CLUSTERS
SHOW COLUMNS
SHOW CONNECTIONS
SHOW CREATE CLUSTER
SHOW CREATE CONNECTION
SHOW CREATE INDEX
SHOW CREATE MATERIALIZED VIEW
SHOW CREATE SINK
SHOW CREATE SOURCE
SHOW CREATE TABLE
SHOW CREATE TYPE
SHOW CREATE VIEW
SHOW DATABASES
SHOW DEFAULT PRIVILEGES
SHOW INDEXES
SHOW MATERIALIZED VIEWS
SHOW NETWORK POLICIES (Cloud)
SHOW OBJECTS
SHOW PRIVILEGES
SHOW ROLE MEMBERSHIP
SHOW ROLES
SHOW SCHEMAS
SHOW SECRETS
SHOW SINKS
SHOW SOURCES
SHOW SUBSOURCES
SHOW TABLES
SHOW TYPES
SHOW VIEWS
SUBSCRIBE
TABLE
UPDATE
VALIDATE CONNECTION
VALUES
SQL functions & operators
Aggregate function filters
array_agg function
CAST function and operator
COALESCE function
csv_extract function
date_bin function
date_part function
date_trunc function
datediff function
encode and decode functions
EXTRACT function
jsonb_agg function
jsonb_object_agg function
justify_days function
justify_hours function
justify_interval function
LENGTH function
list_agg function
map_agg function
normalize function
now and mz_now functions
Pushdown functions
string_agg function
SUBSTRING function
Table functions
TIMEZONE and AT TIME ZONE functions
to_char function
SQL data types
Array types
boolean type
bytea type
date type
Floating-point types
Integer types
interval type
jsonb type
List types
map type
mz_aclitem type
mz_timestamp type
numeric type
oid type
record type
text type
time type
Timestamp types
Unsigned Integer types
uuid type
System catalog
mz_catalog
pg_catalog
information_schema
mz_internal
mz_introspection
SQL identifiers
SQL namespaces
Explain plan operators
About
Support
License
Materialize Cloud Security and Compliance
Responsible disclosure policy
Close
Arrow Pointing to the left
All Topics
Home
/
Developer tools
/
mz - Materialize CLI
mz Reference
View as Markdown
mz app-password
mz config
mz profile
mz region
mz secret
mz sql
mz user
Back to top ↑