Merge pull request #273529 from AlicjaKucharczyk/20240426-postgrestosql

formating

Author: JamesJBarnett

articles/postgresql/flexible-server/generative-ai-azure-cognitive.md

@@ -27,7 +27,7 @@ Azure AI extension gives the ability to invoke the [Azure AI Language Services](
 
 In the Language resource, under **Resource Management** > **Keys and Endpoint** you can find the endpoint, keys, and Location/Region for your language resource. Use the endpoint and key to enable `azure_ai` extension to invoke the model deployment. The Location/Region setting is only required for the translation function.
 
-```postgresql
+```sql
 select azure_ai.set_setting('azure_cognitive.endpoint','https://<endpoint>.cognitiveservices.azure.com');
 select azure_ai.set_setting('azure_cognitive.subscription_key', '<API Key>');
 -- the region setting is only required for the translate function
@@ -40,7 +40,7 @@ select azure_ai.set_setting('azure_cognitive.region', '<Region>');
 
 ### `azure_cognitive.analyze_sentiment`
 
-```postgresql
+```sql
 azure_cognitive.analyze_sentiment(text text, language text DEFAULT NULL::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.analyze_sentiment(text text[], language text DEFAULT NULL::text, batch_size integer DEFAULT 10, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.analyze_sentiment(text text[], language text[] DEFAULT NULL::text[], batch_size integer DEFAULT 10, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
@@ -92,7 +92,7 @@ For more information, see Cognitive Services Compliance and Privacy notes at htt
 
 ### `azure_cognitive.detect_language`
 
-```postgresql
+```sql
 azure_cognitive.detect_language(text text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.detect_language(text text[], batch_size integer DEFAULT 1000, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 ```
@@ -139,7 +139,7 @@ For more information, see Cognitive Services Compliance and Privacy notes at htt
 
 ### `azure_cognitive.extract_key_phrases`
 
-```postgresql
+```sql
 azure_cognitive.extract_key_phrases(text text, language text DEFAULT NULL::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.extract_key_phrases(text text[], language text DEFAULT NULL::text, batch_size integer DEFAULT 10, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.extract_key_phrases(text text[], language text[] DEFAULT NULL::text[], batch_size integer DEFAULT 10, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
@@ -191,7 +191,7 @@ For more information, see Cognitive Services Compliance and Privacy notes at htt
 
 ### `azure_cognitive.linked_entities`
 
-```postgresql
+```sql
 azure_cognitive.linked_entities(text text, language text DEFAULT NULL::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.linked_entities(text text[], language text DEFAULT NULL::text, batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.linked_entities(text text[], language text[] DEFAULT NULL::text[], batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
@@ -248,7 +248,7 @@ For more information, see Cognitive Services Compliance and Privacy notes at htt
 
 [Named Entity Recognition (NER) feature in Azure AI](../../ai-services/language-service/named-entity-recognition/overview.md) can identify and categorize entities in unstructured text.
 
-```postgresql
+```sql
 azure_cognitive.recognize_entities(text text, language text DEFAULT NULL::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.recognize_entities(text text[], language text DEFAULT NULL::text, batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.recognize_entities(text text[], language text[] DEFAULT NULL::text[], batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
@@ -300,7 +300,7 @@ For more information, see Cognitive Services Compliance and Privacy notes at htt
 
 ### `azure_cognitive.recognize_pii_entities`
 
-```postgresql
+```sql
 azure_cognitive.recognize_pii_entities(text text, language text DEFAULT NULL::text, domain text DEFAULT 'none'::text, disable_service_logs boolean DEFAULT true, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.recognize_pii_entities(text text[], language text DEFAULT NULL::text, domain text DEFAULT 'none'::text, batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT true, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.recognize_pii_entities(text text[], language text[] DEFAULT NULL::text[], domain text DEFAULT 'none'::text, batch_size integer DEFAULT 5, disable_service_logs boolean DEFAULT true, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
@@ -358,7 +358,7 @@ For more information, see Cognitive Services Compliance and Privacy notes at htt
 
 [Document abstractive summarization](../../ai-services/language-service/summarization/overview.md) produces a summary that might not use the same words in the document but yet captures the main idea.
 
-```postgresql
+```sql
 azure_cognitive.summarize_abstractive(text text, language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.summarize_abstractive(text text[], language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.summarize_abstractive(text text[], language text[] DEFAULT NULL::text[], sentence_count integer DEFAULT 3, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
@@ -412,7 +412,7 @@ For more information, see Cognitive Services Compliance and Privacy notes at htt
 
 [Document extractive summarization](../../ai-services/language-service/summarization/how-to/document-summarization.md) produces a summary extracting key sentences within the document.
 
-```postgresql
+```sql
 azure_cognitive.summarize_extractive(text text, language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, sort_by text DEFAULT 'offset'::text, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.summarize_extractive(text text[], language text DEFAULT NULL::text, sentence_count integer DEFAULT 3, sort_by text DEFAULT 'offset'::text, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.summarize_extractive(text text[], language text[] DEFAULT NULL::text[], sentence_count integer DEFAULT 3, sort_by text DEFAULT 'offset'::text, batch_size integer DEFAULT 25, disable_service_logs boolean DEFAULT false, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
@@ -473,7 +473,7 @@ For example, if invoked with a `text` set to `'PostgreSQL features transactions
 
 ### `azure_cognitive.translate`
 
-```postgresql
+```sql
 azure_cognitive.translate(text text, target_language text, source_language text DEFAULT NULL::text, text_type text DEFAULT 'Plain'::text, profanity_action text DEFAULT 'NoAction'::text, profanity_marker text DEFAULT 'Asterisk'::text, suggested_source_language text DEFAULT NULL::text, source_script text DEFAULT NULL::text, target_script text DEFAULT NULL::text, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.translate(text text, target_language text[], source_language text DEFAULT NULL::text, text_type text DEFAULT 'Plain'::text, profanity_action text DEFAULT 'NoAction'::text, profanity_marker text DEFAULT 'Asterisk'::text, suggested_source_language text DEFAULT NULL::text, source_script text DEFAULT NULL::text, target_script text[] DEFAULT NULL::text[], timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_cognitive.translate(text text[], target_language text, source_language text DEFAULT NULL::text, text_type text DEFAULT 'Plain'::text, profanity_action text DEFAULT 'NoAction'::text, profanity_marker text DEFAULT 'Asterisk'::text, suggested_source_language text DEFAULT NULL::text, source_script text DEFAULT NULL::text, target_script text DEFAULT NULL::text, batch_size integer DEFAULT 1000, timeout_ms integer DEFAULT NULL::integer, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
@@ -483,7 +483,7 @@ azure_cognitive.translate(text text[], target_language text[], source_language t
 > [!NOTE]  
 > Translation is only available in version 0.2.0 of azure_ai extension. To check the version, check the pg_available_extensions catalog view.
 
-```postgresql
+```sql
 select * from pg_available_extensions where name = 'azure_ai';
 ```
 
@@ -551,14 +551,14 @@ For more information on parameters, see [Translator API](../../ai-services/trans
 
 ### Sentiment analysis examples
 
-```postgresql
+```sql
 select b.*
 from azure_cognitive.analyze_sentiment('The book  was not great, It is mediocre at best','en') b
 ```
 
 ### Summarization examples
 
-```postgresql
+```sql
 SELECT
     bill_id,
     unnest(azure_cognitive.summarize_abstractive(bill_text, 'en')) abstractive_summary
@@ -568,7 +568,7 @@ WHERE bill_id = '114_hr2499';
 
 ### Translation examples
 
-```postgresql
+```sql
 -- Translate into Portuguese
 select  a.*
 from azure_cognitive.translate('Language Translation in real time in multiple languages is quite cool', 'pt') a;
@@ -580,7 +580,7 @@ from azure_cognitive.translate('Language Translation in real time in multiple la
 
 ### Personal data detection examples
 
-```postgresql
+```sql
 select
     'Contoso employee with email [email protected] is using our awesome API' as InputColumn,
     pii_entities.*

articles/postgresql/flexible-server/generative-ai-azure-machine-learning.md

@@ -29,7 +29,7 @@ Azure AI extension gives the ability to invoke any machine learning models deplo
 
 In the Azure Machine Learning studio, under **Endpoints** > **Pick your endpoint** > **Consume** you can find the endpoint URI and Key for the online endpoint. Use these values to configure the `azure_ai` extension to use the online inferencing endpoint.
 
-```postgresql
+```sql
 select azure_ai.set_setting('azure_ml.scoring_endpoint','<URI>');
 select azure_ai.set_setting('azure_ml.endpoint_key', '<Key>');
 ```
@@ -38,7 +38,7 @@ select azure_ai.set_setting('azure_ml.endpoint_key', '<Key>');
 
 Scores the input data invoking an Azure Machine Learning model deployment on an [online endpoint](../../machine-learning/how-to-authenticate-online-endpoint.md).
 
-```postgresql
+```sql
 azure_ml.inference(input_data jsonb, timeout_ms integer DEFAULT NULL, throw_on_error boolean DEFAULT true, deployment_name text DEFAULT NULL)
 ```
 
@@ -70,7 +70,7 @@ azure_ml.inference(input_data jsonb, timeout_ms integer DEFAULT NULL, throw_on_e
 
 This calls the model with the input_data and returns a jsonb payload.
 
-```postgresql
+```sql
 -- Invoke model, input data depends on the model.
   SELECT * FROM azure_ml.inference('
   {

articles/postgresql/flexible-server/generative-ai-azure-openai.md

@@ -28,7 +28,7 @@ Invoke [Azure OpenAI embeddings](../../ai-services/openai/reference.md#embedding
 
 In the Azure OpenAI resource, under **Resource Management** > **Keys and Endpoints** you can find the endpoint and the keys for your Azure OpenAI resource. To invoke the model deployment, enable the `azure_ai` extension using the endpoint and one of the keys.
 
-```postgresql
+```sql
 select azure_ai.set_setting('azure_openai.endpoint', 'https://<endpoint>.openai.azure.com'); 
 select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>'); 
 ```
@@ -37,7 +37,7 @@ select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>');
 
 Invokes the Azure OpenAI API to create embeddings using the provided deployment over the given input.
 
-```postgresql
+```sql
 azure_openai.create_embeddings(deployment_name text, input text, timeout_ms integer DEFAULT 3600000, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 azure_openai.create_embeddings(deployment_name text, input text[], batch_size integer DEFAULT 100, timeout_ms integer DEFAULT 3600000, throw_on_error boolean DEFAULT true, max_attempts integer DEFAULT 1, retry_delay_ms integer DEFAULT 1000)
 ```
@@ -77,7 +77,7 @@ azure_openai.create_embeddings(deployment_name text, input text[], batch_size in
 
 ## Use OpenAI to create embeddings and store them in a vector data type
 
-```postgresql
+```sql
 -- Create tables and populate data
 DROP TABLE IF EXISTS conference_session_embeddings;
 DROP TABLE IF EXISTS conference_sessions;

articles/postgresql/flexible-server/generative-ai-azure-overview.md

@@ -26,7 +26,7 @@ Before you can enable `azure_ai` on your Azure Database for PostgreSQL flexible
 
 Then you can install the extension, by connecting to your target database and running the [CREATE EXTENSION](https://www.postgresql.org/docs/current/static/sql-createextension.html) command. You need to repeat the command separately for every database you want the extension to be available in.
 
-```postgresql
+```sql
 CREATE EXTENSION azure_ai;
 ```
 
@@ -58,7 +58,7 @@ The `azure_ai_settings_manager` role is by default granted to the `azure_pg_admi
 
 Used to set configuration options.
 
-```postgresql
+```sql
 azure_ai.set_setting(key TEXT, value TEXT)
 ```
 
@@ -80,7 +80,7 @@ Name of a configuration option. Valid values for the `key` are:
 
 Used to obtain current values of configuration options.
 
-```postgresql
+```sql
 azure_ai.get_setting(key TEXT)
 ```
 
@@ -100,7 +100,7 @@ Name of a configuration option. Valid values for the `key` are:
 
 ### `azure_ai.version`
 
-```postgresql
+```sql
 azure_ai.version()
 ```
 
@@ -112,21 +112,21 @@ azure_ai.version()
 
 #### Set the Endpoint and an API Key for Azure OpenAI
 
-```postgresql
+```sql
 select azure_ai.set_setting('azure_openai.endpoint','https://<endpoint>.openai.azure.com'); 
 select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>'); 
 ```
 
 #### Get the Endpoint and API Key for Azure OpenAI
 
-```postgresql
+```sql
 select azure_ai.get_setting('azure_openai.endpoint');
 select azure_ai.get_setting('azure_openai.subscription_key');
 ```
 
 #### Check the Azure AI extension version
 
-```postgresql
+```sql
 select azure_ai.version();
 ```
 

articles/postgresql/flexible-server/generative-ai-recommendation-system.md

@@ -33,7 +33,7 @@ Before you can enable `azure_ai` and `pgvector` on your Azure Database for Postg
 
 Then you can install the extension, by connecting to your target database and running the [CREATE EXTENSION](https://www.postgresql.org/docs/current/static/sql-createextension.html) command. You need to repeat the command separately for every database you want the extension to be available in.
 
-```postgresql
+```sql
 CREATE EXTENSION azure_ai;
 CREATE EXTENSION pgvector;
 ```
@@ -42,7 +42,7 @@ CREATE EXTENSION pgvector;
 
 In the Azure AI services under **Resource Management** > **Keys and Endpoints** you can find the endpoint and the keys for your Azure AI resource. Use the endpoint and one of the keys to enable `azure_ai` extension to invoke the model deployment.
 
-```postgresql
+```sql
 select azure_ai.set_setting('azure_openai.endpoint','https://<endpoint>.openai.azure.com'); 
 select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>'); 
 ```
@@ -58,7 +58,7 @@ select azure_ai.set_setting('azure_openai.subscription_key', '<API Key>');
 
 ### Create the table
 
-```postgresql
+```sql
 CREATE TABLE public.recipes( 
     rid integer NOT NULL, 
     recipe_name text, 
@@ -101,15 +101,15 @@ psql -d <database> -h <host> -U <user> -c "\copy recipes FROM <local recipe data
 
 ### Add a column to store the embeddings
 
-```postgresql
+```sql
 ALTER TABLE recipes ADD COLUMN embedding vector(1536); 
 ```
 
 ### Generate embeddings
 
 Generate embeddings for your data using the azure_ai extension. In the following, we vectorize a few different fields, concatenated:
 
-```postgresql
+```sql
 WITH ro AS (
     SELECT ro.rid
     FROM
@@ -136,7 +136,7 @@ Repeat the command, until there are no more rows to process.
 
 Create a search function in your database for convenience:
 
-```postgresql
+```sql
 create function
     recommend_recipe(sampleRecipeId int, numResults int) 
 returns table(
@@ -169,7 +169,7 @@ language plpgsql;
 
 Now just invoke the function to search for the recommendation:
 
-```postgresql
+```sql
 select out_recipename, out_similarityscore from recommend_recipe(1, 20); -- search for 20 recipe recommendations that closest to recipeId 1
 ```