{"id":7687,"library":"rockset","title":"Rockset Python Client","description":"The Rockset Python client (`rockset`) provides an SDK for interacting with the Rockset API, a real-time analytics database. It enables users to create and manage resources, execute queries, and handle data. However, as of June 2024, Rockset's public services were shut down following its acquisition by OpenAI, with its technology integrated into OpenAI's infrastructure. Consequently, this client library is no longer functional for public use and is preserved for archival purposes.","status":"abandoned","version":"2.1.2","language":"en","source_language":"en","source_url":"https://github.com/rockset/rockset-python-client","tags":["database","api-client","data-analytics","abandoned"],"install":[{"cmd":"pip install rockset","lang":"bash","label":"Install with pip"}],"dependencies":[{"reason":"Required Python version range for the library.","package":"python","version":">=3.6, <4.0"}],"imports":[{"symbol":"rockset","correct":"import rockset"},{"note":"The main client class was renamed from 'Client' to 'RocksetClient' in v1.0.0.","wrong":"from rockset import Client","symbol":"RocksetClient","correct":"from rockset import RocksetClient"},{"symbol":"Regions","correct":"from rockset import Regions"},{"symbol":"Configuration","correct":"from rockset import Configuration"}],"quickstart":{"code":"import os\nfrom rockset import RocksetClient, Regions, ApiException\n\n# Rockset services were shut down in June 2024. This code is for archival/demonstration only.\n# Ensure ROCKSET_API_KEY is set in your environment variables if attempting to run against a hypothetical Rockset instance.\napi_key = os.environ.get('ROCKSET_API_KEY', 'YOUR_ROCKSET_API_KEY')\nif api_key == 'YOUR_ROCKSET_API_KEY':\n    print(\"WARNING: ROCKSET_API_KEY environment variable not set. Using placeholder.\")\n\ntry:\n    # Initialize the Rockset client\n    # The host parameter replaced 'api_server' in v1.0.0\n    rs = RocksetClient(host=Regions.use1a1, api_key=api_key)\n\n    # Example: List workspaces\n    print(\"Attempting to list workspaces...\")\n    workspaces = rs.Workspaces.list_all()\n    print(f\"Found {len(workspaces)} workspaces:\")\n    for ws in workspaces:\n        print(f\"- {ws.name}\")\n\n    # Example: Create an API key (demonstration, real usage should handle existing keys)\n    # This operation will likely fail as the service is offline.\n    try:\n        new_api_key_name = \"my-test-api-key\"\n        print(f\"\\nAttempting to create API key: {new_api_key_name}...\")\n        created_key = rs.APIKeys.create(name=new_api_key_name, role=\"member\")\n        print(f\"Successfully created API key: {created_key.name}\")\n    except ApiException as e:\n        print(f\"Could not create API key (expected due to service shutdown): {e}\")\n\nexcept ApiException as e:\n    print(f\"An API error occurred: {e}\")\nexcept Exception as e:\n    print(f\"An unexpected error occurred: {e}\")","lang":"python","description":"Initializes the Rockset client using an API key from an environment variable and attempts to list workspaces and create an API key. Note that this code will not function as Rockset's public services have been shut down."},"warnings":[{"fix":"No direct fix; the underlying service is unavailable. The library is for archival/historical purposes.","message":"Rockset's public cloud service was shut down in June 2024 following its acquisition by OpenAI. The Python client library is no longer functional for connecting to a live Rockset service.","severity":"breaking","affected_versions":"All versions post-June 2024"},{"fix":"Update client instantiation from `Client(api_server=...)` to `RocksetClient(host=...)`. Review endpoint and parameter names in the updated documentation for v1.","message":"Migration from v0 to v1 of the client library introduced breaking changes. The main client class was renamed from `Client` to `RocksetClient`, the `api_server` parameter for specifying the API location was changed to `host`, and the query builder was deprecated. Some endpoints and parameters were also renamed.","severity":"breaking","affected_versions":"<1.0.0 to >=1.0.0"},{"fix":"Set environment variables: `CERT_PATH=$(python3 -m certifi); export SSL_CERT_FILE=${CERT_PATH}; export REQUESTS_CA_BUNDLE=${CERT_PATH}`. As a last resort, SSL verification can be disabled via `config.verify_ssl = False`, but this is not recommended for production.","message":"Users may encounter SSL errors when using the client, potentially due to Python installation issues.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Instead of `QueryRequestSql(sql='SELECT * FROM my_collection')`, use `{'sql': 'SELECT * FROM my_collection'}`.","message":"When making requests, certain parameters often expect instances of `rockset.models` classes (e.g., `rockset.models.QueryRequestSql`). For brevity, you can often pass a dictionary instead of instantiating the model object directly.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"fix":"Run `pip install rockset` to install the library.","cause":"The `rockset` library is not installed in the current Python environment.","error":"ModuleNotFoundError: No module named 'rockset'"},{"fix":"Change `Client` to `RocksetClient`. Ensure you import it with `from rockset import RocksetClient`.","cause":"Attempting to use the old client class name `Client` after upgrading to v1.0.0 or later, where it was renamed.","error":"NameError: name 'Client' is not defined"},{"fix":"Verify that your `ROCKSET_API_KEY` is correct and has appropriate permissions. Given the service shutdown, this error is now expected.","cause":"The provided API key is invalid, missing, or lacks the necessary permissions, or the service is no longer available.","error":"rockset.ApiException: (401)\nReason: Unauthorized"},{"fix":"Replace `api_server` with `host`. Example: `RocksetClient(host=Regions.use1a1, api_key=...)`.","cause":"Attempting to use the old `api_server` parameter for host configuration with `RocksetClient` (v1.0.0+).","error":"TypeError: __init__() got an unexpected keyword argument 'api_server'"}]}