In this commit we update the documentation for Google El Carro for Oracle Workloads. We amend the documentation in the Google Providers page to use the correct name which is El Carro for Oracle Workloads. We also add changes to the document_loaders and memory pages to reflect changes we made in our repo.
"You can find the hostname and port values in the status of the El Carro\n",
"`ElCarroEngine` configures a connection pool to your Oracle database, enabling successful connections from your application and following industry best practices."
"Kubernetes instance.\n",
],
"Use the user password you created for your PDB."
"metadata": {
]
"collapsed": false
}
},
},
{
{
"cell_type": "code",
"cell_type": "code",
@ -362,7 +408,8 @@
" elcarro_engine=elcarro_engine,\n",
" elcarro_engine=elcarro_engine,\n",
" TABLE_NAME=TABLE_NAME,\n",
" TABLE_NAME=TABLE_NAME,\n",
")\n",
")\n",
"loader.load()"
"loaded_docs = loader.load()\n",
"print(f\"Loaded Documents: [{loaded_docs}]\")"
]
]
},
},
{
{
@ -421,10 +468,10 @@
"specify the list of `metadata_columns` we want it to have. In this example, the\n",
"specify the list of `metadata_columns` we want it to have. In this example, the\n",
"created table will have table columns:\n",
"created table will have table columns:\n",
"\n",
"\n",
"- description (type: text): for storing fruit description.\n",
"- content (type: text): for storing fruit description.\n",
"- fruit_name (type text): for storing fruit name.\n",
"- type (type text): for storing fruit type.\n",
"- organic (type tinyint(1)): to tell if the fruit is organic.\n",
"- weight (type INT): for storing fruit weight.\n",
"- other_metadata (type: JSON): for storing other metadata information of the\n",
"- extra_json_metadata (type: JSON): for storing other metadata information of the\n",
"> Google [El Carro Oracle Operator](https://github.com/GoogleCloudPlatform/elcarro-oracle-operator) offers a way to run Oracle databases in Kubernetes as a portable, open source, community driven, no vendor lock-in container orchestration system. El Carro provides a powerful declarative API for comprehensive and consistent configuration and deployment as well as for real-time operations and monitoring. Extend your database application to build AI-powered experiences leveraging Oracle Langchain integrations.\n",
"> Google [El Carro Oracle Operator](https://github.com/GoogleCloudPlatform/elcarro-oracle-operator) offers a way to run Oracle databases in Kubernetes as a portable, open source, community driven, no vendor lock-in container orchestration system. El Carro provides a powerful declarative API for comprehensive and consistent configuration and deployment as well as for real-time operations and monitoring. Extend your Oracle database's capabilities to build AI-powered experiences by leveraging the El Carro Langchain integration.\n",
"\n",
"\n",
"This guide goes over how to use the El Carro Langchain integration to store chat message history with the `ElCarroChatMessageHistory` class.\n",
"This guide goes over how to use the El Carro Langchain integration to store chat message history with the `ElCarroChatMessageHistory` class. This integration works for any Oracle database, regardless of where it is running.\n",
"\n",
"\n",
"[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/googleapis/langchain-google-el-carro-python/blob/main/docs/chat_message_history.ipynb)"
"[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/googleapis/langchain-google-el-carro-python/blob/main/docs/chat_message_history.ipynb)"
]
]
@ -20,7 +20,7 @@
"## Before You Begin\n",
"## Before You Begin\n",
"\n",
"\n",
"To run this notebook, you will need to do the following:\n",
"To run this notebook, you will need to do the following:\n",
" * Complete the [Getting Started](https://github.com/googleapis/langchain-google-el-carro-python/tree/main/README.md#getting-started) section"
" * Complete the [Getting Started](https://github.com/googleapis/langchain-google-el-carro-python/tree/main/README.md#getting-started) section if you would like to run your Oracle database with El Carro."
]
]
},
},
{
{
@ -122,14 +122,12 @@
"metadata": {},
"metadata": {},
"source": [
"source": [
"### Set Up Oracle Database Connection\n",
"### Set Up Oracle Database Connection\n",
"You can find the hostname and port values in the status of the El Carro\n",
"Fill out the following variable with your Oracle database connections details."
"Kubernetes instance. Use the user password you created for your PDB."
]
]
},
},
{
{
"cell_type": "code",
"cell_type": "code",
"execution_count": null,
"execution_count": null,
"metadata": {},
"outputs": [],
"outputs": [],
"source": [
"source": [
"# @title Set Your Values Here { display-mode: \"form\" }\n",
"# @title Set Your Values Here { display-mode: \"form\" }\n",
@ -236,6 +236,22 @@ See a [usage example](/docs/integrations/document_loaders/google_cloud_storage_f
from langchain_community.document_loaders import GCSFileLoader
from langchain_community.document_loaders import GCSFileLoader
```
```
### El Carro for Oracle Workloads
> Google [El Carro Oracle Operator](https://github.com/GoogleCloudPlatform/elcarro-oracle-operator)
offers a way to run Oracle databases in Kubernetes as a portable, open source,
community driven, no vendor lock-in container orchestration system.
```bash
pip install langchain-google-el-carro
```
See [usage example](/docs/integrations/document_loaders/google_el_carro).
```python
from langchain_google_el_carro import ElCarroLoader
```
### Google Drive
### Google Drive
>[Google Drive](https://en.wikipedia.org/wiki/Google_Drive) is a file storage and synchronization service developed by Google.
>[Google Drive](https://en.wikipedia.org/wiki/Google_Drive) is a file storage and synchronization service developed by Google.
@ -315,22 +331,6 @@ See [usage example](/docs/integrations/document_loaders/google_spanner).
from langchain_google_spanner import SpannerLoader
from langchain_google_spanner import SpannerLoader
```
```
## El Carro Oracle Operator
> Google [El Carro Oracle Operator](https://github.com/GoogleCloudPlatform/elcarro-oracle-operator)
offers a way to run Oracle databases in Kubernetes as a portable, open source,
community driven, no vendor lock-in container orchestration system.
```bash
pip install langchain-google-el-carro
```
See [usage example](/docs/integrations/document_loaders/google_el_carro).
```python
from langchain_google_el_carro import ElCarroLoader
```
### Speech-to-Text
### Speech-to-Text
> [Google Cloud Speech-to-Text](https://cloud.google.com/speech-to-text) is an audio transcription API powered by Google's speech recognition models in Google Cloud.
> [Google Cloud Speech-to-Text](https://cloud.google.com/speech-to-text) is an audio transcription API powered by Google's speech recognition models in Google Cloud.
@ -737,7 +737,7 @@ from langchain_community.agent_toolkits import GmailToolkit
### AlloyDB for PostgreSQL
### AlloyDB for PostgreSQL
> [AlloyDB](https://cloud.google.com/alloydb) is a fully managed relational database service that offers high performance, seamless integration, and impressive scalability on Google Cloud. AlloyDB is 100% compatible with PostgreSQL.
> [AlloyDB for PostgreSQL](https://cloud.google.com/alloydb) is a fully managed relational database service that offers high performance, seamless integration, and impressive scalability on Google Cloud. AlloyDB is 100% compatible with PostgreSQL.
Install the python package:
Install the python package:
@ -797,6 +797,22 @@ See [usage example](/docs/integrations/memory/google_cloud_sql_mssql).
from langchain_google_cloud_sql_mssql import MSSQLEngine, MSSQLChatMessageHistory
from langchain_google_cloud_sql_mssql import MSSQLEngine, MSSQLChatMessageHistory
```
```
## El Carro for Oracle Workloads
> Google [El Carro Oracle Operator](https://github.com/GoogleCloudPlatform/elcarro-oracle-operator)
offers a way to run Oracle databases in Kubernetes as a portable, open source,
community driven, no vendor lock-in container orchestration system.
```bash
pip install langchain-google-el-carro
```
See [usage example](/docs/integrations/memory/google_el_carro).
```python
from langchain_google_el_carro import ElCarroChatMessageHistory
```
### Spanner
### Spanner
> [Google Cloud Spanner](https://cloud.google.com/spanner/docs) is a fully managed, mission-critical, relational database service on Google Cloud that offers transactional consistency at global scale, automatic, synchronous replication for high availability, and support for two SQL dialects: GoogleSQL (ANSI 2011 with extensions) and PostgreSQL.
> [Google Cloud Spanner](https://cloud.google.com/spanner/docs) is a fully managed, mission-critical, relational database service on Google Cloud that offers transactional consistency at global scale, automatic, synchronous replication for high availability, and support for two SQL dialects: GoogleSQL (ANSI 2011 with extensions) and PostgreSQL.