From 220683cef001305d0ab456b8d3f8f28f8b1767b9 Mon Sep 17 00:00:00 2001
From: steve-chavez <stevechavezast@gmail.com>
Date: Tue, 11 Jul 2023 10:31:51 -0500
Subject: [PATCH] add HEAD optimization

---
 docs/references/api/tables_views.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/references/api/tables_views.rst b/docs/references/api/tables_views.rst
index 19f651d40..3d4bb9b31 100644
--- a/docs/references/api/tables_views.rst
+++ b/docs/references/api/tables_views.rst
@@ -685,6 +685,14 @@ If we make a similar request on ``bigtable``, which has 3573458 rows, we would g
   HTTP/1.1 206 Partial Content
   Content-Range: 0-24/3572000
 
+.. _head_req:
+
+HEAD
+----
+
+A HEAD method will behave identically to GET except that no body will be returned (`RFC 2616 <https://datatracker.ietf.org/doc/html/rfc2616#section-9.4>`_) .
+As an optimization, the generated query won't execute an aggregate (to avoid unnecessary data transfer).
+
 .. _update:
 
 Update